4everCraft Mod

The front door for shared commands and foundational mod behavior. If you are exploring the project, start here to understand the big picture before diving into subsystems.

AI plumbing lives here: request safety, resilience, and provider orchestration. Think of this package as the reliability layer behind smart NPC features.

Client-only bootstrap and rendering glue. This is where visual behavior is wired in without affecting dedicated server runtime.

Combat context tracking used by gameplay logic and NPC reactions. Small, focused state helpers that make interactions feel intentional.

Core menu building blocks and top-level UI flows. Use this package when designing player journeys, menu structure, and interaction affordances.

Arena setup and editing screens. This is your workspace for map/admin tools that shape playable spaces.

Compatibility UI adapters (especially Bedrock/Floodgate paths). Keeps user experience consistent across different client capabilities.

The game-hub experience: launch pages, selectors, and mode routing. Great entry point for adding a new mini-game page.

Jeeves brain and action orchestration. Prompts, command interpretation, memory hooks, and behavior policies are coordinated here.

Jeeves in-world entity implementation: motion, combat, follow behavior, and visuals. Touch this package when changing how Jeeves feels in play.

Lorekeeper narrative systems: interviews, books, reputation, scheduling, and memory tagging. This package powers the story layer of the server.

Lorekeeper entity runtime behavior and effects. A focused place for animation/interaction details tied to the NPC presence.

Automated game tests for Lorekeeper workflows. Use these tests to lock in behavior while iterating quickly.

Custom items used by Lorekeeper flows. Small item-specific logic that supports narrative gameplay loops.

Mario mode integration hub: config, toggles, registry, and coordination across client/server systems. Start here for high-level movement-style features.

Mario client event loops and frame/tick-driven behavior. If movement or camera feel changes, this package is usually part of the path.

Mario cap items and item-triggered mechanics. Useful for gameplay tuning around power-up feel.

Material/surface translation maps for libsm64 physics. This is where Minecraft blocks are interpreted for Mario movement behavior.

Mario packet definitions and sync handlers. Keeps state aligned across clients/servers while preserving responsive local feel.

SM64 enums/constants mirrored for integration. Consider this the vocabulary used by higher-level Mario systems.

Low-level native bridge types and calls for libsm64. Performance-sensitive interoperability layer; change carefully and intentionally.

BlueMap marker domain and service APIs. This package ties world points of interest to map-facing features.

Shared MCP protocol and tool-host foundation. Central location for automation-friendly interfaces to mod functionality.

Network transport for MCP requests/responses. Handles wire-level movement of MCP payloads.

Safety policies and validation guards for automated actions. Use this package to keep tool execution practical and safe.

Server-facing MCP module and tool handlers. This is where game-state automation endpoints are implemented.

Client-side MCP tool implementations and affordances. Focused command helpers for player-facing automation tasks.

Reusable MCP utility helpers (parsing, coordinate logic, compression). Common low-friction building blocks for feature work.

Mini-game framework primitives and shared lifecycle contracts. Best starting point for adding or refactoring a game mode.

Arena domain operations and creation helpers. Maps game intent onto editable world geometry.

Reference mini-game implementation. A compact blueprint for building new modes quickly.

Team Deathmatch implementation (rules, classes, bots, sessions). Use this package for competitive mode tuning.

TNT Survival implementation and ruleset orchestration. Focused survival-challenge game loop components.

Zombie Survival implementation and wave/mob logic. Core package for PvE pressure and pacing adjustments.

Server/common mixin entry package. Houses low-level injections that adapt vanilla behavior for mod systems.

Client mixin entry package for rendering/input hooks. Integrates client-side behavior with minimal invasive changes.

Mario-specific client injections for rendering/camera/input behavior. Useful when animation and visual feel need surgical control.

Presence-specific client injections for chat/input/model overlays. Connects passive player signals to visible UX.

Mario-specific server/common mixin hooks. Bridges vanilla server behavior with Mario movement/state systems.

Presence-specific server mixin hooks around inventory and interaction events. Generates the raw signals used by presence sync.

Presence state model and high-level behavior. Tracks typing/menu/idle activity to make multiplayer feel socially alive.

Presence packet transport and synchronization handlers. Delivers lightweight activity signals between clients and server.