<div align="center"> <h1>mSurvival</h1> <p>A lightweight, modular, and essential core for your Minecraft Survival server.</p> </div> --- ## 🌟 Overview **mSurvival** is the definitive lightweight core designed for modern Survival servers (1.21.11). Built with performance in mind, it consolidates all the essential survival features into a single, modular plugin. Tired of installing multiple plugins for homes, spawn, RTP, and utility commands? **mSurvival** replaces them all with a clean, optimized, and fully translatable system, reducing clutter while keeping your server fast and efficient. ## ✨ Features * **🏠 Home GUI System**: Manage homes through an intuitive menu. * Left-click to teleport * Right-click to delete * Configurable max homes * **🌍 Spawn System**: Set a global spawn with `/setspawn` and teleport players instantly with `/spawn`. * **🎲 Async RTP**: Safe random teleport that finds a valid location before teleporting (no lag spikes). * **🎮 Gamemode Commands**: Quick commands (`/gmc`, `/gms`, `/gma`, `/gmsp`) with player targeting support. * **🔙 Back System**: Return to your last location after teleport or death using `/back`. * **🗑️ Trash GUI**: 54-slot inventory to safely delete unwanted items (`/trash`). * **⚙️ Modular System**: Enable or disable every feature directly from the config. * **🌐 Fully Translatable**: All messages are editable in `messages.yml`. * **🎨 Color Support**: Supports both classic (`&`) and **HEX colors** (`&#RRGGBB`). * **🚀 Lightweight & Optimized**: Built for modern Paper servers with zero performance impact. ## 📥 Installation 1. Download the `mSurvival.jar` file and place it into your server's `plugins` folder. 2. Restart your server. 3. Configure settings in `config.yml`. 4. Customize messages in `messages.yml`. --- ## ⚙️ config.yml The main configuration file handles all technical settings and module toggles: <details> <summary>Click to view default config.yml</summary> ```yaml # mSurvival - Configuration File # This file contains ONLY technical settings. modules: gamemode: true spawn: true home: true back: true rtp: true trash: true spawn: world: world x: 0.5 y: 64.0 z: 0.5 yaw: 0.0 pitch: 0.0 home: max-homes: 3 rtp: radius: 5000 min-radius: 100 max-attempts: 20 ``` </details> --- ## 🌐 messages.yml This file contains all plugin messages and supports full color customization: <details> <summary>Click to view default messages.yml</summary> ```yaml # mSurvival - Messages File # Supports & color codes and &#RRGGBB hex colors. prefix: "&8 " no-permission: "&cYou don't have permission to do that." player-only: "&cThis command can only be used by players." player-not-found: "&cPlayer '&e{player}&c' not found or not online." module-disabled: "&cThis module is currently disabled." # --- Gamemode --- gamemode: set-self: "&aYour gamemode has been set to &e{mode}&a." set-other: "&aSet &e{player}&a's gamemode to &e{mode}&a." set-other-notify: "&aYour gamemode was set to &e{mode} &aby &e{sender}&a." invalid: "&cInvalid gamemode. Use: 0/creative, 1/survival, 2/adventure, 3/spectator." # --- Spawn --- spawn: set: "&aSpawn location has been set!" teleported: "&aYou have been teleported to spawn." not-set: "&cSpawn location is not set. Ask an admin to use /setspawn." # --- Home --- home: set: "&aHome '&e{home}&a' has been set!" deleted: "&aHome '&e{home}&a' has been deleted." teleported: "&aTeleported to home '&e{home}&a'." max-reached: "&cMaximum number of homes reached (&e{max}&c)." gui: title: "&8&lYour Homes" item-name: "&b{home}" item-lore: - "&7Left-click to &aTeleport" - "&7Right-click to &cDelete" # --- Other --- rtp: searching: "&eSearching for a safe location..." teleported: "&aTeleported to a random location!" back: teleported: "&aReturned to your previous location." trash: title: "&8&lTrash" ``` </details> --- <div align="center"> <p>Developed with ❤️ by <b>sonoMiky</b></p> </div>