ClientCore Wiki

ClientCore is a Paper/Folia plugin for player-specific client-side gameplay: fake blocks, personal loot chests, personal ground drops, client-owned mobs, and client-only NPCs.

The important idea is that most features are real server logic with client-specific visibility. For example, a block regen node is sent as a fake block packet to one player, while another player may see normal world terrain. Client mobs are still server entities, but ClientCore hides and protects them so only their owner can see and interact with them.

Requirements

• Paper/Folia matching the plugin build target.
• PacketEvents bundled in the shaded ClientCore jar. A compatible external PacketEvents plugin may also be used.
• Java version supported by your server build.
• SQLite or MySQL JDBC driver available on the server classpath if your selected database needs it.

Optional integrations:

• PlaceholderAPI for conditions.
• WorldGuard for block regen region flags.
• MMOItems for configured item rewards.
• MythicMobs for client-owned mobs and MythicMob NPCs.
• ModelEngine for MythicMobs models.
• Citizens or FancyNpcs for NPC providers.

First Setup

1. Put ClientCore-1.0-all.jar in plugins/.
2. Add any optional hook plugins you use.
3. Start the server once.
4. Edit files under plugins/ClientCore/.
5. Run /clientcore reload.
6. Use /clientcore status to confirm loaded block and mob rule counts.

Main Topics

• Configuration Layout
• Main Configuration
• Conditions
• Commands
• Client Builds
• Folia Compatibility
• Changelog
• Blocks Regeneration
• Loot Chests
• Ground Drops
• Mobs
• NPCs
• Messages
• Troubleshooting

Fast Folder Example

All feature folders support multiple YAML files. This is valid:

plugins/ClientCore/
  config.yml
  messages.yml
  blocks/
    coal.yml
    ores/deepslate.yml
  mobs/
    tutorial.yml
    bosses/wither.yml
  drops/
    tutorial.yml

Inside each feature file you can use either the full root, a rules: root, or direct rule IDs. See Configuration Layout for the exact rules.