i113w's Camera Lib

i113w's Camera Lib

Клиентская библиотека для NeoForge 1.21.1, предоставляющая полноценную камеру в стиле RTS — включая перемещение камеры, выделение сущностей рамкой, зоны команд по правому клику, рейкаст и отрисовку подсветки.

Создана для использования другими модами (например, Better Mine Team) через тонкий слой API.

Требования

Подключение библиотеки

Локальный JAR (положите JAR в папку libs/ вашего мода):

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

Объявите зависимость в META-INF/neoforge.mods.toml:

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

Ключевые интерфейсы и классы

CameraLibAPI — единая точка входа

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 — внедрение игровой логики

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

Регистрируется через CameraLibAPI.get().setInteractionDelegate(impl).

События (вызываются на NeoForge.EVENT_BUS)

RTSBoxSelectEvent — завершено выделение левым кликом или рамкой

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

RTSRightClickEvent — завершён правый клик или протяжка правой кнопкой

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

RTSCameraController — состояние камеры

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

Режимы камеры

Отрисовка подсветки

Библиотека автоматически рисует контуры сущностей, когда камера активна. Никакого кода отрисовки в моде-потребителе не нужно — просто синхронизируйте CameraLibAPI.setSelectedEntities(...).

Конфигурация

Настраиваемые игроком значения в .minecraft/config/i113w_camera_lib-client.toml:

Лицензия

MIT — см. LICENSE

Автор: i113w