Epic Camera

作者：epic_lover

Shoulder-camera offset keys for Epic Fight: fine, smooth, swap shoulder, camera coupling.

模组 Forge 修复前置库实用附属

介绍

中文介绍正在准备中，下面暂时显示原文。

Description

Adds in-game controls for Epic Fight’s third-person camera: move the camera left/right, up/down and closer/farther with the keyboard, swap shoulders with one key, and toggle camera coupling. It is made for setups that use Epic Fight’s own camera (with or without Better Lock On) instead of Shoulder Surfing.

Features

Fine-grained offset – the camera position is stored in blocks (X / Y / Z) instead of Epic Fight’s coarse integer steps. Holding a key moves the camera 0.025 blocks per tick by default.
Smooth movement – the camera glides to its new position when you adjust it, swap shoulders or reset.
Swap shoulder – flips the camera to the other side with one key.
Wide limits – X ±8, Y -4 to 6, Z 0.5 to 12 blocks by default, all configurable.
Camera coupling toggle – when on, the player always faces where the camera looks; when off, Epic Fight’s normal decoupled camera is used. It has no effect while locked on to a target.
Wall collision – the camera stops at blocks instead of clipping into them.
Own settings for Epic Fight’s camera – the mod can force Epic Fight’s camera mode, lock-on range, quick shift and perspective toggle mode from its own config, so the Epic Fight options screen can’t change them. Turn this off with one option.
Keep lock-on when changing perspective – Epic Fight releases lock-on when you press F5 and the camera leaves third-person-back (for example back to first person). This mod can keep the lock-on instead; it is configurable.
Offsets and coupling state are saved automatically.

Default keys

Action	Key
Camera left / right	Left / Right arrow
Camera up / down	Page Up / Page Down
Camera closer / farther	Up / Down arrow
Swap shoulder	Keypad 7
Reset offset	Unbound
Toggle camera coupling	Unbound

All keys can be rebound in the Controls menu under Epic Fight Shoulder Offset.

Configuration

config/efshoulder-client.toml

[offset] – current offsets and the values used by the reset key.
[limits] – min / max for X, Y and Z.
[adjust] – step (blocks per tick while a key is held) and smoothSpeed.
[coupling] – coupled.
[lockOn] – keepLockOnWhenChangingPerspective (default true; set false for Epic Fight’s original behaviour).
[epicfight] – overrideEpicFightCamera and the Epic Fight values to enforce (cameraMode, lockOnRange, lockOnQuickShift, cameraPerspectiveToggleMode).

Notes

Client-side only. Requires Minecraft 1.20.1, Forge 47+ and Epic Fight 20.14+.
While overrideEpicFightCamera is on, Epic Fight’s own camera horizontal / vertical / zoom sliders are kept at neutral values and have no effect; use this mod’s keys and config instead.
Works with Better Lock On. Not intended to be used together with Shoulder Surfing, since both control the camera.