i113w's Camera Lib

A NeoForge 1.21.1 client-side library that provides a complete RTS-style camera system — including camera movement, entity box-selection, right-click command zones, ray casting, and highlight rendering.

Designed to be consumed by other mods (e.g., Better Mine Team) via a thin API layer.

Requirements

Item Version Minecraft 1.21.1 NeoForge 21.1.209+ Java 21 Side Client-only

Importing the Library

Local JAR (place the JAR in your mod's libs/ directory):

dependencies { implementation files('libs/i113w_camera_lib-0.0.1.jar') }

Declare the dependency in META-INF/neoforge.mods.toml:

[[dependencies."your_mod_id"]] modId = "i113w_camera_lib" type = "required" versionRange = "[0.0.1,)" ordering = "BEFORE" side = "CLIENT"

Key Interfaces & Classes

CameraLibAPI — singleton entry point

CameraLibAPI api = CameraLibAPI.get(); // Register your delegate api.setInteractionDelegate(new MyDelegate()); // Sync selected entity IDs to the library (drives outline rendering) api.setSelectedEntities(Set<Integer> ids); // Query hovered entity (-1 if none) int id = api.getHoveredEntityId(); // Clear selection and hover state api.clearSelection();

IRTSInteractionDelegate — inject business logic

public interface IRTSInteractionDelegate { boolean isSelectable(Entity entity); ResourceLocation getCursorIcon(@Nullable Entity hoveredEntity, boolean isAttackDragging); }

Events (fired on NeoForge.EVENT_BUS)

RTSBoxSelectEvent — left-click or drag-box completed

@SubscribeEvent public static void onSelect(RTSBoxSelectEvent event) { List<Entity> candidates = event.getCandidates(); // pre-filtered by isSelectable() }

RTSRightClickEvent — right-click or right-drag completed

@SubscribeEvent public static void onRightClick(RTSRightClickEvent event) { if (event.isDrag()) { List<Entity> targets = event.getDragTargets(); } else { HitResult hit = event.getSingleHitResult(); // BlockHitResult or EntityHitResult } }

RTSCameraController — camera state

RTSCameraController cam = RTSCameraController.get(); cam.toggleRTSMode(); // activate / deactivate cam.toggleCameraStyle(); // switch RTS <-> FREE (while active) cam.isActive(); // boolean cam.reset(); // force-exit, use on logout / level unload

Camera Modes

Mode FOV Zoom Yaw Rotation RTS 25° (fixed) Scroll wheel Hold Left Ctrl + drag (snaps by rtsSnapAngle) FREE Standard Scroll wheel (moves forward) Hold Left Ctrl + drag (continuous)

Highlight Rendering

The library automatically draws entity outlines when the camera is active. No rendering code is needed in the consumer mod — just keep CameraLibAPI.setSelectedEntities(...) in sync.

Color Condition White Entity ID is in the selected set Yellow Hovered entity (not in selected set)

Configuration

Player-adjustable values in .minecraft/config/i113w_camera_lib-client.toml:

Key Default Description rtsPitchMin / Max 35 / 45 Pitch clamp range in RTS mode freePitchMin / Max 10 / 90 Pitch clamp range in FREE mode rtsZoomMin / Max 10 / 80 Zoom distance clamp in RTS mode rtsZoomSpeedMultiplier 3.5 Scroll wheel zoom sensitivity rtsSnapAngle 90 Degrees per yaw snap step freeRotationSpeed 5.0 Mouse yaw sensitivity in FREE mode thresholdPx 20 Edge-pan trigger distance (pixels from screen edge) baseSpeed 1.0 WASD movement speed sprintMultiplier 2.0 Speed multiplier when sprint key is held