DMRP

DMRP - Role Play Plugin for Minecraft

Introduction

DMRP is a Minecraft plugin designed to enhance role-playing experiences on your server. It introduces new commands and mechanics that can be used to create immersive role-playing scenarios. This plugin is compatible with Minecraft servers running Spigot or Bukkit.

modrinth

github

Features

- Auto Update: Allow players to leash each other using a leash. - Auto Update: Allows locking and unlocking of player inventories, preventing them from moving items using a chain. - Auto Update: Allows players to throw dice with a specified number of sides. Players can throw a single die or multiple dice at once. - Auto Update: Gives players a customizable chance to succeed in a specified action. This can be used for various role-playing scenarios. - Auto Update: Simulates a coin flip with a 50/50 chance of landing on heads or tails. - Auto Update: Reloads the plugin's configuration files, allowing changes to take effect without restarting the server. - Auto Update: If installed, DMRP can use placeholders to customize messages further. - Auto Update: DMRP can use MiniMassages format to customize messages further. - Auto Update: Introduces new custom placeholders that allow server administrators to dynamically display plugin-specific data, such as player state. - Auto Update: Automatically checks for plugin updates.

See command showcase on:

modrinth-gallery

Installation

1. Download the latest version of DMRP from the Modrinth or GitHub repository. 2. Download the latest version of PacketEvents from the Modrinth or other source 3. Place the downloaded `.jar` file into your server's `plugins` directory. 4. Restart your server to load the plugin.

Configuration

DMRP uses two configuration files: `config.yaml` and `language.yaml`. These files are located in the plugin's directory under `plugins/DMRP/`.

- `config.yaml`: Contains settings such as the maximum dice sides, and leash distance. - `language.yaml`: Contains messages used by the plugin, which can be customized to fit your server's theme.

Commands

- /leash {player}: Reloads the plugin's configuration files. - /leash {player}: Attempts a specified action with a configured chance of success. - /leash {player}: Throws a specified number of dice with a specified number of sides. - /leash {player}: Simulates a coin flip with a 50/50 chance. - /leash {player}: Locks or unlocks the inventory of a specified player. - /leash {player}: Leashes/unleashes a player.

Custom Placeholders

DMRP introduces custom placeholders that allow server administrators to dynamically display plugin-specific data. These placeholders can be used with PlaceholderAPI to enhance the role-playing experience. Below is a description of each placeholder:

- %dmrp_leashed%: Displays whether a player is currently leashed. - Returns a customizable message based on the player's leash status: - If the player is leashed: Displays the message defined in `placeholder.leash.leashed` in the `language.yaml` file. - If the player is not leashed: Displays the message defined in `placeholder.leash.not_leashed`.

- %dmrp_lockinv%: Displays whether a player's inventory is locked. - Returns a customizable message based on the player's inventory lock status: - If the player's inventory is locked: Displays the message defined in `placeholder.lockinv.locked` in the `language.yaml` file. - If the player's inventory is unlocked: Displays the message defined in `placeholder.lockinv.unlocked`.

These placeholders can be customized in the `language.yaml` file to fit your server's theme and enhance immersion.

Permissions

DMRP uses a permission system to control access to its commands. By default, all commands (except /rp-reload) are restricted to all users. You can customize these permissions in your server's `permissions.yml` file.

Permission Nodes

- `dmrp.command.*`: Gives access to all DMRP commands. - `dmrp.command.reload`: Access to reload the plugin configuration. - `dmrp.command.try`: Access to the `/try` command. - `dmrp.command.dice`: Access to the `/dice` command. - `dmrp.command.coinflip`: Access to the `/coinflip` command. - `dmrp.command.lockinv`: Access to the `/lockinv` command. - `dmrp.command.leash`: Access to the `/leash` command.

- `dmrp.leash.use`: Allows players to leash others. - `dmrp.leash.can`: Allows players to be leashed. - `dmrp.leash.admin`: Gives access to unleash players that you don't own.

- `dmrp.lock.use`: Gives access to lock players inventories. - `dmrp.lock.can`: Allows players to be inventory locked. - `dmrp.lock.admin`: Gives access to unlock inventories that you don't own.

Support

If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub repository.

Contributing

Contributions to DMRP are welcome! If you'd like to contribute, please fork the repository, make your changes, and submit a pull request.

License

DMRP is licensed under the BSD-3 License. See the `LICENSE.md` file for more details.