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.

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