Before integrating your website with ZonelyCore, ensure you are using the latest official version. The plugin is being updated to newer versions, and the link is currently under maintenance.
Features
- SecureSocket Support: Execute commands from the website securely in-game.
- Site Profile Menu: Reflect player profiles from the site to the game.
- Site Store: Sync up to 8 product models between the site and the game. Allows in-game purchases.
- Recent Donors: Displays players who recently purchased credits with 7 sorting options.
- Credit Paper: Convert site credits into tradeable in-game papers. Players can transfer or sell them through menus or NPCs.
- Credit Transfers: Transfer credits in-game. Credits can be removed or modified.
- Disguise: Hide player names and ranks in-game.
- Auctions: Players can create personal markets to sell items using credits both in-game and on the site.
- Recent Purchase Placeholder: Displays the most recent purchase via placeholders.
- Boosters: Add multipliers to credit rewards through server or global boosters.
- Player Messaging: Send private messages between players.
- Rewards System: Players with specific permissions can claim periodic rewards from a menu.
- Achievements: Displays an achievement menu based on AlonsoLeagues configurations.
- Player Customization: Toggle visibility, chat, and death effects via menu.
- Chat Colors: Manage chat colors via menus, compatible with the ChatColor plugin.
- Titles: Assign custom titles after player ranks.
- Punishments: Sync punishments from the website to the server, including warnings, bans, and mutes with category-based protection.
Requirements
- PlaceholderAPI 2.11.6 (Required): Download
- ProtocolLib 5.3.0 (Required): Download
- ChatColor 2.7.11 (Optional): Download
- AlonsoLeagues 0.9.3 (Optional): Download
Placeholder Usage
| Placeholder | Description | Example |
|---|
| %zonely_playername% | Player name with prefix | |
| %zonely_status_online_name% | Online status with name | |
| %zonely_powder% | Particle data | |
| %zonely_status_online% | Online status | |
| %zonely_status_delivery% | Delivery status | |
| %zonely_last_sale% | Last purchase | |
| %zonely_cash% | Credits | |
| %zonely_perm% | Permission group | |
| %zonely_mysteryboxes% | Mystery boxes | |
Commands
| Command | Description |
|---|
| /zc | Opens ZonelyCore menu |
| /creditpaper (cash) | Converts credits into papers |
| /lastcredits | Displays last credit transactions |
| /auctions add (cash) | Adds an auction item |
| /punishment | Opens punishment menu |
| /store | Opens store menu |
| /myboughts | Shows owned items |
| /auctions | Opens auction menu |
| /webprofile | Displays web profile |
| /team | Team menu |
| /disguise or /d | Activates disguise |
| /sale | Sale menu |
| /message | Send message |
| /credit | Credit transfer menu |
1. Connect the plugin to the database
Open /plugins/ZonelyCore/config.yml and configure the database section as shown:
database:
type: 'MySQL'
mysql:
hikari: false
mariadb: false
host: DATABASE_HOST
port: DATABASE_PORT
name: DATABASE_NAME
username: DATABASE_USERNAME
password: DATABASE_PASSWORD
mongodb:
url: ''
If the database details are incorrect or incompatible with other systems, the plugin may not work or cause errors.
2. Enable SecureSocket
SecureSocket securely executes commands from the website in-game using encrypted data. It ensures only verified commands from the site are executed by the console.
Open /plugins/ZonelyCore/config.yml and configure:
web-token: TOKEN # Enter the token created on the site. Used for command execution.
socket-port: CUSTOM_PORT # Port for the site-to-server connection.
3. Add an Auction Server
Auctions allow players to sell items in a market system using credits. Purchases made through the site or in-game will use SecureSocket or WebSender for delivery. Once the server is added, items can be given to players via /mezatoyunver player productID.
4. Add Member Groups
The plugin supports custom rank tags. You can display permissions with %zonely_core_perm%. Example configuration:
groups:
kurucu:
name: '&4Kurucu'
prefix: '&c'
permission: 'group.kurucu'
alwaysvisible: true
5. Disguise System
The disguise system lets players hide or change their names and permissions in-game.
disguise:
groups:
- 'previp'
- 'mvip'
randoms:
- 'Mosary'
- 'GlueMan'
- 'Rosbeff'
- 'Zonely'
kick-apply: '&6&l- Disguise - \n \n&eTo apply your disguise, please rejoin the server.'
kick-remove: '&6&l- Disguise - \n \n&cNo available disguise name found. Please rejoin the server.'
6. Add Rewards
Rewards can be configured for users with specific permissions to claim periodically from the menu.
deliveries:
vipdaily:
slot: 11
days: 1
permission: 'group.vip'
icon: 'STAINED_CLAY:5 : 1 : name>&6&lVIP {color}&lDaily Reward : desc>&8[Reward]\n \n&fOnly &6VIP &fplayers can claim this reward periodically.\n \n&f* Reward Content:\n&7 &8▪ &6300 [GOLD]\n&7 &8▪ &d1 [MYSTERY BOX]\n&7 &8▪ &c1 &l[2x MULTIPLIER] &c[GLOBAL BOOSTER] &7(1 Hour)\n&7 &8▪ &31 &l[2x MULTIPLIER] &3[SERVER BOOSTER] &7(2 Hours)\n'
message: '&3Lobby &8» &6VIP Daily &ereward claimed successfully.'
rewards:
- 'CASH>300'
- 'PRIVATE_BOOSTER>1:2.0:1'
- 'NETWORK_BOOSTER>1:2.0:2'
- 'COMMAND>wmb give {name} 1'
Congratulations! You can now use ZonelyCore with full functionality.
