RP Plugin

RPPlugin

RPPlugin is a comprehensive roleplay-focused plugin for Minecraft servers Spigot/Paper 1.16.x - 1.21.1 that enhances immersive roleplay with advanced character interaction commands. Perfect for RP servers, events, or survival communities seeking deeper in-character communication.

🎭 Features

Core Roleplay Commands

- `/roll <number>`: Describe your character's actions in the third person - `/roll <number>`: Describe surrounding events and environmental actions - `/roll <number>`: Attempt an action with configurable success chance - `/roll <number>`: Roll dice with advanced dice notation support

New Enhanced Features

- Emote Library: Send messages with short distance for private conversations - Emote Library: Broadcast messages with extended range for shouting - Emote Library: Perform predefined emotes with optional targets - Emote Library: Support for complex dice expressions (2d6+3, 1d20, etc.) - Emote Library: Fully customizable output messages with color codes - Emote Library: Toggle distance-based message delivery on/off - Emote Library: Built-in collection of common roleplay emotes

💬 Commands

| Command | Description | Usage Examples | |---------|-------------|----------------| | `/rp help` | Describe your character's actions | `/me smiles warmly` | | `/rp help` | Describe events in the world | `/do A cold breeze passes by` | | `/rp help` | Roll dice with various formats | `/roll 20`, `/roll 5-15`, `/roll 2d6+3` | | `/rp help` | Attempt an action with chance | `/try open the rusty door` | | `/rp help` | Send a quiet message | `/whisper Hey, come here` | | `/rp help` | Shout a message loudly | `/yell Help! I'm over here!` | | `/rp help` | Perform an emote | `/emote wave`, `/emote smile John` | | `/rp help` | Show command help | `/rp help` |

🎲 Dice System Examples

The plugin supports multiple dice notation formats:

```yaml /roll 20 # Roll 1-20 (traditional) /roll 5-15 # Roll between 5 and 15 /roll d6 # Roll one six-sided die /roll 2d10 # Roll two ten-sided dice /roll 1d20+5 # Roll d20 and add 5 /roll 3d6+2 # Roll three d6 and add 2 ```

😄 Available Emotes

The plugin includes a library of common roleplay emotes:

- `wave` - Waves at someone - `cry` - Cries - `dance` - Dances happily - `laugh` - Laughs out loud - `bow` - Bows respectfully - `nod` - Nods in agreement - `shake` - Shakes head in disagreement - `shrug` - Shrugs shoulders - `smile` - Smiles warmly - `wink` - Winks playfully

You can easily add more emotes in the configuration file!

⚙️ Configuration

The plugin features extensive configuration with multiple language support:

```yaml

Language settings

language: "en"

Plugin settings

settings: message_distance: 100.0 # Default message range use_distance: true # Enable/disable distance check try_success_chance: 0.5 # Success chance for /try command

Message formatting

formats: me: "&d* %player% %action% *" do: "&e* %action% (%player%) *" roll_simple: "&a%player% rolls %roll% (1-%max%)" roll_range: "&a%player% rolls %roll% (%min%-%max%)" roll_dice: "&a%player% rolls %roll% (%expression%)" try_success: "&9%player% tries to %action% and succeeds!" try_fail: "&9%player% tries to %action% and fails!" whisper: "&7[Whisper] %player%: %message%" yell: "&c[Yell] %player%: %message%" emote: "&6* %player% %emote% %target% *"

Emote definitions

emotes: wave: "waves" cry: "cries" dance: "dances" laugh: "laughs" bow: "bows" nod: "nods" shake: "shakes head" shrug: "shrugs" smile: "smiles" wink: "winks"

Multi-language support

messages: en:

English messages...

ru:

Russian messages...

```

🔧 Installation

1. Download the latest `RPPlugin.jar` 2. Place it in your server's `plugins/` directory 3. Restart your server 4. Configure `plugins/RPPlugin/config.yml` to your preferences 5. Use `/rp help` in-game to see available commands

📋 Requirements

- Java: Spigot or Paper 1.16.x - 1.21.1 - Java: Version 21 or higher recommended