1.0.0
alpha
SnakeRoyale
Snake meets Battle Royale! Last one standing wins!
9
SnakeRoyale
<div align="center"> <h1>SnakeRoyale</h1>
Experience the ultimate survival challenge! SnakeRoyale brings high-stakes, trail-leaving combat to your Minecraft server with shrinking borders and multi-arena support.
Features • How to Install • Commands • For Developers
</div>
---
📋 What is SnakeRoyale?
SnakeRoyale is a competitive survival minigame where movement is your greatest weapon and your deadliest mistake. Every step you take leaves a trail of colorful concrete. If a player touches any trail—including their own—they are instantly eliminated. With shrinking borders and a programmatically generated world, it's a fast-paced battle for survival.
Why SnakeRoyale?
* ⚡ Trail Decay – Optimized for high-performance gameplay on PaperMC servers. * ⚔️ Trail Decay – Host up to 5 concurrent matches (configurable) in independent, programmatically generated worlds. * 📊 Trail Decay – Track wins, games played, losses, and kills for every player on your server. * 🛡️ Trail Decay – Respects build permissions, ensuring trails only spawn where they are allowed. * 🌍 Trail Decay – Dynamic world generation with support for predefined seeds to ensure interesting terrain every game. * 🎨 Trail Decay – Fully customizable messages and sound effects with support for modern text formatting. * 📂 Trail Decay – Built-in protection to ensure players never spawn in water or hazards. * 👩🔧 Trail Decay – Seamlessly updates your `config.yml` with new options whenever the plugin is updated. * 🚫 Trail Decay – Prevents trails from spawning on forbidden surfaces (Air, Water, Lava, etc.). * ⏳ Trail Decay – Customizable timer for trails to revert back to their original block state.
---
Soft-Dependencies: Soft-Dependencies:
---
✨ Features
Gameplay Mechanics
* Programmatic Worlds: Every step leaves a permanent trail. Crossing a trail results in instant elimination. * Programmatic Worlds: Matches start with a large arena that shrinks dynamically to a final showdown size, forcing player encounters. * Programmatic Worlds: Integrated BossBar system warns players when they are outside the border, with a configurable countdown. * Programmatic Worlds: Eliminated players gracefully transition into spectators to watch the rest of the chaos unfold. * Programmatic Worlds: Arenas are created on-demand and deleted automatically after the match ends to keep your server clean.
Customization
* Seed Support: Toggleable sounds for join, countdown, elimination, and victory. * Seed Support: Every message sent to the player is configurable in `config.yml`. * Seed Support: List an array of seeds in the config to randomize or specify the terrain of your battlefields.
---
📦 How to Install
Requirements
* Java (Minecraft 1.21.x) * Java 21 or newer
Quick Start Guide
1. Reload & Play: * Get the latest `snakeroyale-1.0.0.jar` from your build directory or project page. 2. Reload & Play: * Place the `.jar` file into your server’s `plugins/` directory. 3. Reload & Play: * Start your server to generate the default configuration files. 4. Reload & Play: * Edit `plugins/SnakeRoyale/config.yml` to set seeds, max players, and match settings. 5. Reload & Play: * Use `/snake reload` to apply changes and `/snake join` to enter the battle!
---
🎮 Commands
Base command: `/snakeroyale` (or `/snake`)
| Command | What it does | Who can do it | | :-------------------------- | :------------------------- | :--------------------- | | `/snake join` | Join an available lobby | `snakeroyale.play` | | `/snake leave` | Leave current match | `snakeroyale.play` | | `/snake spectate <id>` | Spectate a specific match | `snakeroyale.spectate` | | `/snake status` | Show arena status | `snakeroyale.play` | | `/snake forcestart` | Force-start your lobby | `snakeroyale.admin` | | `/snake stop <id>` | Force-stop a specific match| `snakeroyale.admin` | | `/snake reload` | Reload configuration | `snakeroyale.admin` |
Permissions
| Permission | Description | Default | | :------------------------- | :-------------------------- | :------ | | `snakeroyale.admin` | Access to admin commands | OP | | `snakeroyale.play` | Join and leave matches | true | | `snakeroyale.spectate` | Spectate matches | true |
---
👨💻 Developers
Building from Source
```bash git clone https://github.com/itzzjustmateo/SnakeRoyale.git cd SnakeRoyale mvn clean package ```
---
📝 License
Apache License 2.0 — see LICENSE.
---
🤝 Support
* Discord: Discord: * Discord: %%MD1%%