Skip to content

VikumKarunathilake/RTP

 
 

Repository files navigation

RTP (Random Teleport Plugin)

Build Status Latest Release Total Downloads License


A maintained fork of the original RTP plugin by DailyStruggle

This repository is an actively maintained fork of the original RTP plugin created by DailyStruggle. Our goals are straightforward:

  • Maintain buildability across environments
  • Ensure compatibility with modern server versions
  • Provide regular updates (currently targets Paper 1.21.8)
  • Deliver stable, reliable releases for the community

While the original project is no longer maintained, this fork ensures RTP continues to work reliably on current Minecraft platforms.


Current Status

  • ✅ Lightly tested on Paper 1.21.8
  • ✅ Compatible with Java 21
  • ✅ Produces fully shaded, dependency-free builds
  • ✅ Automated releases via GitHub Actions on the main branch

Original Author

Full credit for the original RTP plugin goes to:

➡️ DailyStruggle

This fork continues their work to ensure ongoing availability, stability, and usability.


About the Plugin

RTP is a high-performance random teleportation plugin featuring:

  • Mathematically consistent random distribution
  • Intelligent learning algorithms to avoid invalid areas
  • Support for multiple RTP regions per world
  • Highly configurable world/region/permission systems
  • Fully customizable messages
  • Extensible architecture for biomes, shapes, protections, and more

This fork preserves the original core functionality while modernizing the build system and runtime environment.


Distribution Shapes

The plugin includes several mathematically sophisticated distribution shapes:

Circle — Exponential Distribution (0.1, 1.0, 10.0)

zu5gW62

Square — Exponential Distribution (0.1, 1.0, 10.0)

3mrkKh1

Circle — Normal Distribution

SUGBQk3

Square — Normal Distribution

pzu9j63

Rectangle — Flat Distribution with Rotation

3Yw2tBj

Additional shapes can be implemented through the plugin's extension API.

See the /addons directory for examples including custom shapes, biome selection, claim plugin integration, and command extensions.


Building from Source

Prerequisites:

  • Java 21
  • Maven 3.8+

Build command:

mvn clean package

The compiled plugin will be available at:

target/RTP-<version>.jar

The output is fully shaded and ready for server deployment.


Development

Development Environment:

  • Maven for dependency and build management
  • GitHub Actions for automated compilation and releases

Contributions are welcome! Feel free to fork, improve, or submit pull requests following standard coding best practices.


Addons & Extensions

The plugin features a flexible extension system supporting:

  • Custom shape implementations
  • Biome selection logic
  • Land-claim plugin integration
  • Command enhancements

Reference implementations and examples are available in the /addons directory.


License

This fork respects the original licensing terms and permissions of the upstream RTP project.