Overview
Welcome to JMenus!
The most powerful and feature-rich menu system plugin for Minecraft servers. Create stunning, interactive GUI menus with ease and zero coding required!
Key Features
Advanced Menu System
Create unlimited custom GUI menus with flexible layouts, custom items, and interactive elements. Support for 1-6 row menus with full customization.
In-Game Editor
Edit menus directly in-game with an intuitive GUI interface. No file editing required! Add items, configure actions, and test instantly.
Rich Actions System
11+ different action types including commands, messages, sounds, teleportation, BungeeCord transfers, economy transactions, and more.
BungeeCord Support
Send players between servers seamlessly with built-in BungeeCord integration. Perfect for network server selectors.
Economy Integration
Full Vault integration for money transactions. Create shops, charge for teleports, or reward players with money.
PlaceholderAPI Support
Dynamic content with full PlaceholderAPI integration plus 15+ built-in placeholders for player and server information.
Technical Specifications
Requirement | Details |
---|---|
Minecraft Version | 1.21+ |
Server Software | Paper, Spigot, Bukkit-based servers |
Java Version | Java 21+ |
Dependencies | None (optional: PlaceholderAPI, Vault) |
Plugin Version | v1.0.0 |
API Version | 1.21 |
What Makes JMenus Special?
- Zero Learning Curve: Intuitive in-game editor makes menu creation effortless
- Performance Optimized: Lightweight and efficient, won't slow down your server
- Highly Customizable: Every aspect can be configured to match your server's style
- Developer Friendly: Clean API for integration with other plugins
- Future Proof: Regular updates and new feature additions
- Professional Support: Active development with community support
Installation
Download JMenus
Download the latest JMenus plugin JAR file from Modrinth or GitHub. Make sure you're getting the version compatible with your Minecraft server version (1.21+).
Tip
Always download from official sources to ensure you get the genuine, safe version.
Place in Plugins Folder
Navigate to your server's plugins directory and place the JMenus JAR file there.
Install Optional Dependencies
For enhanced functionality, install these optional plugins:
- PlaceholderAPI - For dynamic placeholders in menus (highly recommended)
- Vault - For economy integration and money actions
Note
JMenus works perfectly without these dependencies, but they unlock additional features.
Restart Your Server
Restart your Minecraft server to load the plugin. JMenus will automatically generate its configuration files and create an example menu.
Verify Installation
Run the following command to verify JMenus is loaded correctly:
You should see the JMenus help menu if installation was successful.
Generated Files
After first startup, JMenus creates these files:
File/Folder | Purpose |
---|---|
config.yml | Main plugin configuration |
menus/ | Folder containing individual menu files |
menus/example_menu.yml | Example menu for reference |
Installation Complete!
JMenus will create an example menu file for you to explore. Use /jmenus open example_menu to see it in action!
Quick Start
Creating Your First Menu (5 Minutes)
Follow this tutorial
Create your first custom menu in under 5 minutes!
Step 1: Create the Menu
This creates a new menu file with basic template items including welcome message and close button.
Step 2: Open the In-Game Editor
This opens the powerful in-game editor where you can visually customize your menu without touching any files.
Step 3: Customize Your Menu
- Edit Items: Add, remove, or modify menu items with visual interface
- Edit Title: Change the menu title with color codes support
- Edit Size: Adjust the menu size from 1-6 rows (9-54 slots)
- Settings: Configure sounds, fill items, and commands
Step 4: Test Your Menu
Open your newly created menu to see it in action!
Example Menu Configuration
Here's what a basic menu configuration looks like:
Congratulations!
You've created your first JMenus menu. Continue reading to discover all the advanced features available!
Download & Support
Official Download Sources
Important
Always download JMenus from official sources to ensure you get the genuine, safe, and latest version.
Support & Contact
Bug Reports & Issues
Report bugs or request features on GitHub Issues
General Support
Get help and chat with the community
Documentation
Complete plugin documentation and guides
Version History
Version | Release Date | Key Features |
---|---|---|
v1.0.0 | Latest | In-game editor, template system, improved actions |
v1.0.0 | Initial | Core menu system, basic actions, configuration |
Commands
Main Command: /jmenus
The primary command for all JMenus functionality.
Aliases: /jmenu, /menus, /jm
Command | Description | Permission | Example |
---|---|---|---|
/jmenus help | Shows help information and available commands | - | /jmenus help |
/jmenus open <menu> | Opens a specific menu for the player | jmenus.open | /jmenus open shop |
/jmenus list | Lists all available menus on the server | jmenus.list | /jmenus list |
/jmenus create <menu> [template] | Creates a new menu with optional template | jmenus.create | /jmenus create shop basic |
/jmenus delete <menu> | Deletes an existing menu permanently | jmenus.delete | /jmenus delete old_menu |
/jmenus edit <menu> | Opens the in-game editor for a menu | jmenus.editor | /jmenus edit shop |
/jmenus reload | Reloads the plugin configuration and menus | jmenus.reload | /jmenus reload |
Editor Command: /jmenuedit
Quick access to the in-game menu editor.
Aliases: /jme, /menuedit
Pro Tip
Use tab completion with all commands to see available options and menu names automatically!
Template Options
When creating menus, you can use these predefined templates:
basic
Simple menu with welcome message and close button
server
Server selector with hub, survival, and creative options
warps
Warp menu with spawn, mine, shop, and PvP warps
shop
Shop categories menu with blocks, tools, and misc
Permissions
Important
JMenus uses a hierarchical permission system. Higher-level permissions automatically include lower-level ones where logical.
Core Permissions
Permission | Description | Default | Level |
---|---|---|---|
jmenus.use | Basic plugin access and usage | true | Player |
jmenus.open | Open menus using commands | true | Player |
jmenus.list | List all available menus | op | Moderator |
jmenus.reload | Reload plugin configuration | op | Admin |
jmenus.create | Create new menus | op | Admin |
jmenus.delete | Delete existing menus | op | Admin |
jmenus.editor | Access in-game menu editor | op | Admin |
Menu-Specific Permissions
Control access to individual menus with specific permissions:
How it works
If a player doesn't have the specific menu permission, they can still open it if they have the general jmenus.open permission, unless you configure menu-specific restrictions.
Permission Configuration in Menu Files
You can add permission requirements directly to menu files:
Configuration
Configuration File
The main configuration file is located at plugins/JMenus/config.yml and controls global plugin behavior.
Plugin Settings
General Settings
Menu Defaults
Default Menu Properties
BungeeCord Configuration
Network Server Support
Important
After modifying the configuration file, use /jmenus reload to apply changes without restarting the server.
Actions System
Actions are the heart of JMenus!
They define what happens when players interact with menu items. You can combine multiple actions for complex behaviors and chain them together.
Available Actions
Message
Send a message to the player
Command
Execute command as the player
Console
Execute command as console (with full permissions)
Sound
Play sound (SOUND:volume:pitch)
Close
Close the current menu
Menu
Open another menu
Teleport
Teleport player to location or another player
Broadcast
Send message to all online players
Bungee
Send player to another BungeeCord server
Permission
Check permission before executing action
Money
Economy transactions (requires Vault)
Click Types
Actions can be triggered by different click types:
Click Type | Description | Common Usage |
---|---|---|
left | Left mouse click | Primary action, most common |
right | Right mouse click | Secondary action, alternatives |
middle | Middle mouse click (scroll wheel) | Special actions |
shift_left | Shift + left click | Advanced actions, admin functions |
shift_right | Shift + right click | Advanced alternatives |
Pro Tip
Actions are executed in order from top to bottom. Use this to create complex conditional logic with permission checks and money verification!
In-Game Editor
The In-Game Editor
JMenus' most powerful feature, allowing you to create and modify menus entirely in-game without touching any configuration files!
Accessing the Editor
or
Required Permission
jmenus.editor (default: OP only)
Editor Interface
Main Editor Menu
The main editor interface provides access to all editing functions:
Edit Items
Add, remove, or modify menu items visually
- Left-click: Edit existing item
- Right-click: Remove item
- Shift-click: Edit item actions
Edit Title
Change the menu title with chat input
- Supports color codes (&)
- Supports placeholders
- Real-time preview
Edit Size
Adjust menu size from 1-6 rows
- Visual size selector
- Automatic slot calculation
- Preserves existing items
Settings
Configure sounds, fill items, and commands
- Open/close sounds
- Fill item configuration
- Direct command setup
Remember
The in-game editor is designed to be intuitive and user-friendly. Experiment with different settings and don't be afraid to try new things - you can always undo changes by editing the menu file manually!
Templates
Templates
Provide pre-built menu configurations for common use cases. They're perfect for quickly creating professional-looking menus without starting from scratch.
Available Templates
Basic Template
Simple menu with welcome message and close button. Perfect for learning or basic functionality.
Server Template
BungeeCord server selector with Hub, Survival, and Creative servers. Ideal for network servers.
Warps Template
Teleportation menu with Spawn, Mine, Shop, and PvP Arena warps. Great for survival servers.
Shop Template
Shopping categories with Blocks, Tools, and Miscellaneous sections. Perfect for economy servers.
Customizing Templates
After creating a menu from a template, you can customize it:
- Create from template: /jmenus create my_menu template_name
- Open editor: /jmenuedit my_menu
- Modify items: Change materials, names, lore, actions
- Add items: Click empty slots to add new items
- Adjust settings: Change title, size, sounds, etc.
Pro Tip
Templates are just starting points! Feel free to completely customize them to match your server's needs and style.
Template Comparison
Template | Size | Items | Best For |
---|---|---|---|
Basic | 3 rows | Welcome, Close | Learning, Simple functionality |
Server | 3 rows | Hub, Survival, Creative servers | BungeeCord networks |
Warps | 4 rows | Spawn, Mine, Shop, PvP warps | Survival/Factions servers |
Shop | 3 rows | Blocks, Tools, Misc categories | Economy servers |
Placeholders
Placeholders
Make your menus dynamic by displaying real-time information about players, servers, and more. JMenus supports both built-in placeholders and PlaceholderAPI integration.
Built-in Placeholders
JMenus includes 15+ built-in placeholders that work without any additional plugins:
Player Placeholders
%player_name% - Player's username
%player_uuid% - Player's UUID
%player_health% - Current health
%player_max_health% - Maximum health
%player_food% - Food level (0-20)
%player_gamemode% - Current gamemode
Location Placeholders
%player_world% - Current world name
%player_x% - X coordinate
%player_y% - Y coordinate
%player_z% - Z coordinate
Server Placeholders
%server_name% - Server name
%server_online% - Online players count
%server_max_players% - Maximum players
%server_version% - Server version
PlaceholderAPI Integration
When PlaceholderAPI is installed, you can use thousands of additional placeholders:
Installation
Simply install PlaceholderAPI and relevant expansion packs. JMenus will automatically detect and support all available placeholders!
BungeeCord Support
BungeeCord Integration
Allows JMenus to send players between servers in your network seamlessly. Perfect for server selectors and network navigation menus.
Setup Requirements
BungeeCord Server
A properly configured BungeeCord proxy server
- Multiple backend servers
- Proper server configurations
- Network connectivity
Plugin Installation
JMenus installed on backend servers
- Install on all backend servers
- Same menu configurations
- Consistent permissions
Configuration
Enable BungeeCord support in config
- Set bungee.enabled: true
- Configure server list
- Set up aliases
Using the Bungee Action
The [bungee] action sends players to other servers:
Basic Usage
Note
BungeeCord support has not been tested with Velocity proxy yet. It should work with standard BungeeCord setups. Report any issues on GitHub!
Economy Integration
Economy Integration
Through Vault allows JMenus to handle money transactions, create shops, charge for services, and reward players with currency.
Install Vault
Download and install the Vault plugin from official sources. Vault acts as a bridge between JMenus and economy plugins.
Install Economy Plugin
Install a Vault-compatible economy plugin such as:
- EssentialsX Economy - Most popular choice
- CMI Economy - Feature-rich alternative
- TNE (The New Economy) - Advanced economy system
- iConomy - Classic economy plugin
Restart Server
Restart your server to ensure all plugins load correctly and Vault detects your economy plugin.
Verify Installation
Test the money action in a menu to ensure everything works properly.
Money Action Usage
The [money] action supports three operations:
Give Money
Add money to player's balance
Take Money
Remove money from player's balance
Check Money
Verify player has enough money
Money Action Syntax
Pro Tip
Combine money actions with permission actions to create sophisticated shop systems with rank-based discounts and exclusive items!
API Documentation
Under Development
The JMenus API documentation is currently being developed and will be available in a future release. This will include comprehensive guides for developers who want to integrate with JMenus programmatically.
Coming Soon
- Complete API reference
- Code examples and tutorials
- Custom action creation guides
- Integration patterns
Stay Updated
Follow the project on GitHub for updates on API development progress and release announcements.
For Developers
If you need immediate API access for your plugin development, please reach out via Discord (J2D) or GitHub Issues for early access documentation and support.
Troubleshooting
Common Issues
Issue | Symptoms | Solution |
---|---|---|
Plugin won't load | Error in console, JMenus commands not working | Check Java version (21+), server compatibility, download from official sources |
Menus don't open | Commands work but no GUI opens | Check permissions, verify menu files exist, check for errors in menu configuration |
Items don't show | Menu opens but appears empty | Verify item configuration syntax, check material names, ensure slots are valid |
Actions don't work | Items show but clicking does nothing | Check action syntax, verify permissions for actions, test with simple actions |
Placeholders not working | Placeholder text shows instead of values | Install PlaceholderAPI, download required expansions, check placeholder syntax |
Debug Mode
Enable debug mode for detailed troubleshooting information:
Then reload the plugin:
Debug Information
Debug mode provides detailed console output about menu loading, action execution, and error details.
Getting Help
Report Bugs
GitHub Issues for bug reports
- Include error logs
- Describe reproduction steps
- Mention server version
- List other installed plugins
Community Support
Discord for general help
- Discord: J2D
- Ask for configuration help
- Share menu examples
- Get quick answers
Documentation
This wiki for complete information
- Read relevant sections
- Check examples
- Follow tutorials
- Review configuration
Self-Diagnosis
Tools for troubleshooting
- Enable debug mode
- Check server console
- Validate YAML syntax
- Test with minimal config
Examples
Real-World Examples
Showcasing different types of menus you can create with JMenus. Copy and customize these examples for your server!
Admin Control Panel
VIP Perks Menu
Customization Tips
These examples are templates! Modify them to match your server's theme, add your own items, change the styling, and integrate with your specific plugins and systems.