HoldYourCamera

Quick rating

Community listing page, reviews here may not be monitored by the author.

How listings work Are you the author?

HoldYourCamera

By shenqianxiaoaaaaa

No reviews yet

Auto camera switch . Just hold an item, press J, pick a camera — per-item perspective rules with zero config-file knowledge required.

Mod Loaders
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

# HoldYourCamera — Store Page (English)

*Developed in pair with Kimi K3 (Moonshot AI).*

## Summary

Hold an item, press J, pick a camera — per-item perspective rules with zero config-file knowledge required.

## Description

**HoldYourCamera** is a tiny client-side QoL mod that switches your camera perspective automatically based on what you're holding. First person for pickaxes, third-person-back for swords, third-person-front for showing off your skin — set it once, and it just works every time you swap items.

### Point-and-click rules — no IDs, no TOML

- **Hold any item and press J**: an editor pops up with the item's icon rendered right there. Pick a scope — *this item only* or *the whole mod* — pick one of three perspectives (first person / third person back / third person front), save, done.
- **Empty-hand J** (or the **Config** button in Forge's mod list) opens the rule manager: global toggles, edit entries, and deletion (inside each rule's edit page).
- Rules are matched top-to-bottom; first match wins.

### Sensible defaults

- When a rule matches, your camera switches; when it stops matching, your **previous perspective is restored** automatically (it remembers what you had before taking over).
- You can still override manually with F5 at any time — unless you enable the global **lock** toggle, which holds the perspective every tick while a rule matches.
- Everything is client-side and per-player: rules live in `config/holdyourcamera-client.toml`, hot-reloaded on save if you prefer hand-editing.

### Requirements

- Minecraft 1.20.1, Forge (expected to run on NeoForge 1.20.1 47.1.x)
- **Client-side only** — safe to use on any server; nothing is sent, nothing is required server-side.

Open source under MIT. Issues and PRs welcome on GitHub.

# HoldYourCamera —— 按主手物品自动切换视角
（Forge 1.20.1 客户端模组）

通过快捷键简便的设置规则(默认为J键)，实现手持指定物品时自动切换视角。

---

本模组由作者与 **Kimi K3（Moonshot AI）** 结对设计并开发：需求讨论、代码实现与调试中均有 AI 参与。

---

## 易用性设计

操作 效果
拿着物品按 `J` 弹出添加窗口：物品图标直接渲染（悬停显示名字），点选 `仅此物品 / 整个模组` + 三种视角，保存即生效
空手按 `J` 打开规则管理界面
模组列表 同样打开管理界面（Forge 官方入口）

管理界面里可以：勾选两个总开关（恢复原视角 / 强制锁定）、点「编辑」进入规则编辑页（编辑页内含删除按钮）、滚动浏览列表。支持传统手写 TOML：`config/holdyourcamera-client.toml`，保存即可热重载。

### 规则行为（默认）

- 命中规则 → 切换视角；不再命中 → 恢复你被接管前的视角（接管时自动记住）
- 手持时仍可 F5 手动覆盖（开了"强制锁定"才会每 tick 锁死）
- 规则按列表顺序匹配，第一条命中的生效