메뉴
Use when changing the knockback engine, profile schema, presets, or config files — the profile system's resolution model, engine order of operations, preset provenance, and the checklist for adding a knob without breaking era exactness.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when a change claims 1.7.10/1.8.9 authenticity or could affect combat feel — the era ground truths, what is client-side and therefore untouchable, the known myths, and the anti-features the community history warns against.
Use when reasoning about knockback, velocity, trajectories, player movement, or any motion math in Mental — the exact Minecraft motion model (identical 1.7.10 → modern for knocked players), its constants, integration order, and the traps that produce block-scale errors.
Use when writing or debugging integration suites in tester/ — FakePlayer's NMS bootstrap and its clientless-player pitfalls, suite timing rules, assertion patterns, and the client-emulation model trajectory tests require.
Use when running, verifying, or debugging Mental's verification gate — which command to run locally vs CI, the matrix shape / per-entry native-era JDK & bytecode tier / suite tiers, how to read results honestly, and the concurrency rules that keep the concurrent Paper servers stall-free.
Use when touching the packet layer — the parse rim (PacketTap/BurstSender/ProbeRim/ValveListener), FeedbackPlan/pre-send behavior, reach validation, PacketEvents usage, or anything that runs on the netty thread.
Use when writing or changing code that must run across Mental's whole Paper range (runtime 1.9.4 → 26.x, 1.17.1 API compile floor) — API selection, version-gated features, reflection, mappings, Java toolchains, the legacy backport tier, or anything that behaves differently per version.
| name | knockback-profiles |
| description | Use when changing the knockback engine, profile schema, presets, or config files — the profile system's resolution model, engine order of operations, preset provenance, and the checklist for adding a knob without breaking era exactness. |
KnockbackProfile record), one file under
profiles/<name>.yml. Ten shipped presets: legacy-1.7 (default),
legacy-1.8, kohi, minehq, badlion, velt, mmc, lunar,
signature, custom. signature is Mental's OWN tuning (not a ported
fork config) — velt's wipe shape tuned to hold the combo reach pocket:
air.horizontal 0.92 + air.vertical 0.98 trim the airborne follow-ups
(the air multipliers apply only to airborne victims, so they retune combo
hits 2+ without touching the grounded opener), and base.vertical 0.365
keeps a touch more lift on descending hits (the 0.36 cap still bites on the
opener). Its 2.2.0 revision (air (0.92, 1.0), base.vertical 0.36) is in
SupersededPresets, so an unedited 2.2.0 file upgrades to the 2.2.1 tune.
Presets are
extracted only when missing — owner edits are
sacred, deleting regenerates pristine — with ONE exception: a file still
matching a superseded bundled revision verbatim (SupersededPresets,
byte-identity after newline normalization — since 2.4.9) is upgraded in
place when research corrects a preset. Any edit at all — a value, a
comment, whitespace — freezes the file forever./mental kb set <player>, and the per-player
API/PlayerKnockbackProfileChangeEvent were removed when management moved
into the in-game GUI. The default is set through the menu's Knockback screen
(Management.setGlobalProfile), which writes the machine overlay
(state/overrides.yml) and reloads — the human knockback.yml is never
re-serialized; KnockbackProfileChangeEvent (no player) fires on a global
change, and the public Mental.setKnockbackProfile(String) shares that same
write-back path. The netty pre-send reads the profile FROZEN into the victim's
per-tick PlayerView, so prediction and truth share one profile.config-v1-backup.yml; tuned knockback becomes profiles/custom.yml,
selected).motion×friction − dir×push; vertical ADD (vy×f + base) or SET
(assigned); horizontal cap rescales; vertical cap clamps BASE onlyparse(empty) == LEGACY_17 stays true.KnockbackProfile.parse + ALL preset yml files + custom.yml
with full comments + project/docs/knockback-profiles.md.PresetsTest + core ProfileParserTest
(each bundled file parses to its Presets constant) — a regenerated preset
can never drift; the docs-cannot-drift KnockbackDocsTest pins every schema
knob into project/docs/knockback-profiles.md.delivery.melee / delivery.projectile: tracker and immediate BOTH
ship the full stamp — vanilla 1.7.10's tracker wire was join-order bimodal
(era-wire-measurements addendum 2) and the dominant mode shipped undecayed,
identical to 1.8.9's in-attack send; the names document provenance, not a
behavioral difference. tracker-decayed is the opt-in later-joiner wire:
one victim-physics-tick decay, friction from the victim's ground state AT
THE HIT (captured at submit; the velocity event fires after fake players
have already physics-ticked airborne). Never ship the decayed wire by
default — that artifact survived a release as "era truth" and read as
broken knockback (~1-block standing flights). LEGACY_17 (and parse-empty)
= tracker/tracker; 1.8-lineage presets (legacy-1.8, mmc, lunar) =
immediate melee; projectile = tracker EVERYWHERE (rod/projectile knocks
rode the tracker on both eras — the old mmc immediate/immediate was wrong
and is superseded). ConfigStore patches the missing block into pre-1.4.0
bundled preset files (never custom.yml). With pre-send on, the netty path
applies the profile's delivery and ships; the authoritative pass ADOPTS
that vector and the duplicate outbound packet is suppressed — one wire
stamp per knock, like the era.