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);