CCORE - ClientSession Control
- By
Advanced server-side client restriction engine, vanilla HUD modifier, and developer API for Minecraft
CCORE - ClientSession Control
CCORE (ClientSession Control) is a lightweight, server-driven client management engine and developer API for Minecraft 1.20.1 (Forge).
Designed specifically for server administrators, RPG creators, and minigame developers, CCORE grants complete server-side control over client mechanics, functional keybinds, inventory access, and vanilla HUD elements without requiring client-side manual configuration.
🛠️ Key Features
Client Function Restrictions
Server operators can lock specific client hotkeys and system functions for competitive fairness or immersive gameplay:
- F1 (Hide HUD) — Prevent players from turning off their interface.
- F2 (Screenshot) — Disable client screenshot capturing during events.
- F3 (Debug Screen) — Hide debug coordinates, chunk borders, and info.
- F5 (Perspective) — Force first-person view (disable F5 camera toggle).
- F11 (Fullscreen) — Block fullscreen toggling.
- Disconnect / Pause Menu — Block the disconnect button during combat or critical story moments.
Inventory & Hotbar Restrictions
- Disable Inventory (
E) — Lock player inventory access programmatically. - Hotbar Slot Limit — Limit the number of selectable hotbar slots (e.g., restrict players to only 1–4 active slots).
Vanilla HUD Transformation Engine
Hide, move, or scale any default Minecraft HUD overlay element on the fly:
- Supported Elements:
minecraft:hotbar,minecraft:health,minecraft:armor,minecraft:food,minecraft:air_level,minecraft:experience_bar,minecraft:crosshair,minecraft:chat,minecraft:player_list,minecraft:boss_event_progress, etc.
Dynamic Server Keybindings
Bind server commands directly to client GLFW keycodes. When a player presses the key, the command is executed automatically from their client.
Global Server Defaults & Live Sync
Configure default restrictions in config/ccore/settings.json. Apply changes instantly to all online players with /ccore reload.
💻 Server Commands
Commands require OP level 2. You can use /ccore or the /clientsession alias.
| Command | Description |
|---|---|
/ccore reload |
Reloads config/ccore/settings.json and syncs default settings to all connected players. |
/ccore <targets> list |
Displays active restrictions, HUD settings, and keybinds for targeted players. |
/ccore <targets> block <f1|f2|f3|f5|f11|disconnect> <true|false> |
Toggles blocking for specific F-keys or disconnect button. |
/ccore <targets> inventory <true|false> |
Disables or enables inventory opening (E). |
/ccore <targets> hotbar <1-9> |
Restricts selectable hotbar slots (1 to 9). |
/ccore <targets> hide <overlay_id> |
Hides a specific vanilla HUD element. |
/ccore <targets> show <overlay_id> |
Restores visibility of a hidden vanilla HUD element. |
/ccore <targets> modify <overlay_id> <offsetX> <offsetY> <scale> |
Offsets and scales a vanilla HUD component. |
/ccore <targets> keybind add <keycode> <command> |
Binds a keycode (e.g., 71 for G) to trigger a server command. |
/ccore <targets> keybind clear |
Clears all custom keybindings for targets. |
🧩 Developer Java API (CCoreAPI)
Third-party Forge mods and custom server scripts can interact directly with net.ccore.api.CCoreAPI to control player sessions programmatically:
```java import net.ccore.api.CCoreAPI; import net.minecraft.server.level.ServerPlayer;
// Lock camera perspective to 1st-person (F5 disabled) CCoreAPI.setFunctionBlocked(player, "f5", true);
// Hide debug info screen (F3 disabled) CCoreAPI.setFunctionBlocked(player, "f3", true);
// Restrict usable hotbar slots to the first 3 slots CCoreAPI.setHotbarLimit(player, 3);
// Lock player inventory GUI access (E key disabled) CCoreAPI.setInventoryDisabled(player, true);
// Hide vanilla food bar from HUD CCoreAPI.setOverlayHidden(player, "minecraft:food", true);
// Reposition & scale vanilla health bar (X+20, Y-10, Scale 1.2x) CCoreAPI.modifyOverlay(player, "minecraft:health", 20.0f, -10.0f, 1.2f);
The CCORE - ClientSession Control Team
