English

Features

Commands

All commands require OP permission (level 2).

Command	Mod Integration	Function
/coldsweat <targets> <add|rm|set> <value>	Cold Sweat	Adjust player's body temperature
/thirst <targets> <add|rm|set> <value>	Thirst Was Taken	Adjust player's thirst level
/realityvalue <targets> <add|rm|set> <health|sanity> <value>	RealityValue	Adjust player's health or sanity (0–20)
/numismaticoverhaul <targets> <add|rm|set> <bronze|silver|gold> <value>	NumismaticOverhaul	Adjust player's currency amounts

FancyMenu Placeholders

Requires the FancyMenu mod. Use the format in text: {"placeholder":"<identifier>","parameter":"<value>"}

Cold Sweat

Identifier	Return Value	Description
current_player_coldsweat	float / false	Player's current body temperature
current_player_coldsweat_percent	0–100	Player's current body temperature as percentage

Thirst Was Taken

Identifier	Return Value	Description
current_player_thirstwastaken	float / false	Player's current thirst level
current_player_thirstwastaken_percent	0–100	Player's current thirst level as percentage
current_player_thirstwastaken_quench	float / false	Player's current quench value
current_player_thirstwastaken_quench_percent	0–100	Player's current quench value as percentage

RealityValue

Identifier	Return Value	Description
current_player_realityvaluesanity	float / false	Player's current sanity
current_player_realityvaluesanity_percent	0–100	Player's current sanity as percentage
current_player_realityvaluehealthy	float / false	Player's current health
current_player_realityvaluehealthy_percent	0–100	Player's current health as percentage

Immersive Aircraft

Identifier	Return Value	Description
current_player_immersive_aircraft_durability	float / false	Current durability of the ridden aircraft (0–100)
current_player_immersive_aircraft_engine	float / false	Current engine power of the ridden aircraft (0–1)

NumismaticOverhaul

Identifier	Return Value	Description
current_player_numismaticoverhaul	numeric / false	Player's currency data; requires the type parameter

Parameters:

• type=bronze – returns the amount of bronze coins (ones and tens place)
• type=silver – returns the amount of silver coins (hundreds and thousands place)
• type=gold – returns the amount of gold coins (ten-thousands place and above)
• type=all – returns total currency value (including all denominations converted)

Example usage: {"placeholder":"current_player_numismaticoverhaul","type":"bronze"}

Native UI Hiding

When integration for a mod is enabled, the mod's native HUD can be automatically hidden to avoid duplicate interface elements. Supported mods:

• Cold Sweat – hides the thermometer HUD
• Thirst Was Taken – hides the thirst HUD
• RealityValue – hides the health/sanity HUD
• Immersive Aircraft – hides the aircraft HUD

Configuration

The configuration file is located at config/commandwithfmplaceholder-common.toml.

[commands]
enableColdSweatCommand = true
enableThirstCommand = true
enableRealityValueCommand = true
enableNumismaticOverhaulCommand = true

[placeholders] enableColdSweatPlaceholders = true enableThirstPlaceholders = true enableRealityValuePlaceholders = true enableImmersiveAircraftPlaceholders = true enableNumismaticOverhaulPlaceholders = true

[original_command_override] disableRealityValueOriginalCommand = true disableNumismaticOverhaulOriginalCommand = true

[hide_native_ui] hideColdSweatNativeUI = true hideThirstNativeUI = true hideRealityValueNativeUI = true hideImmersiveAircraftNativeUI = true

## Dependencies

### Required

- Minecraft 1.21.1
- NeoForge >= 21.1.228

### Optional

- **FancyMenu** >= 3.0 – placeholder functionality
- **Cold Sweat** >= 2.0 – temperature integration
- **Thirst Was Taken** >= 1.21.1-2 – thirst integration
- **RealityValue** >= 1.0 – health/sanity integration
- **Immersive Aircraft** >= 1.0 – aircraft placeholders
- **NumismaticOverhaul** >= 1.21.1-2 – currency integration
- **CmPlugins** >= 1.0 – additional compatibility

All dependencies are optional; features are automatically disabled when the corresponding mod is not installed.

---

# 中文
## 功能

### 命令

所有命令需要 OP 权限（等级 2）。

| 命令 | 联动模组 | 功能 |
|------|----------|------|
| `/coldsweat <targets> <add\|rm\|set> <value>` | Cold Sweat | 调整玩家体温值 |
| `/thirst <targets> <add\|rm\|set> <value>` | Thirst Was Taken | 调整玩家口渴值 |
| `/realityvalue <targets> <add\|rm\|set> <health\|sanity> <value>` | RealityValue | 调整玩家健康值或理智值（0~20） |
| `/numismaticoverhaul <targets> <add\|rm\|set> <bronze\|silver\|gold> <value>` | NumismaticOverhaul | 调整玩家货币量 |

### FancyMenu 占位符

需要安装 FancyMenu 模组。在文本中使用格式：`{"placeholder":"<identifier>","参数名":"<值>"}`

#### Cold Sweat
| 标识符 | 返回值 | 说明 |
|--------|--------|------|
| `current_player_coldsweat` | 浮点数 / `false` | 玩家当前体温值 |
| `current_player_coldsweat_percent` | 0~100 | 玩家当前体温百分比 |

#### Thirst Was Taken
| 标识符 | 返回值 | 说明 |
|--------|--------|------|
| `current_player_thirstwastaken` | 浮点数 / `false` | 玩家当前口渴值 |
| `current_player_thirstwastaken_percent` | 0~100 | 玩家当前口渴值百分比 |
| `current_player_thirstwastaken_quench` | 浮点数 / `false` | 玩家当前解渴值 |
| `current_player_thirstwastaken_quench_percent` | 0~100 | 玩家当前解渴值百分比 |

#### RealityValue
| 标识符 | 返回值 | 说明 |
|--------|--------|------|
| `current_player_realityvaluesanity` | 浮点数 / `false` | 玩家当前理智值 |
| `current_player_realityvaluesanity_percent` | 0~100 | 玩家当前理智值百分比 |
| `current_player_realityvaluehealthy` | 浮点数 / `false` | 玩家当前健康值 |
| `current_player_realityvaluehealthy_percent` | 0~100 | 玩家当前健康值百分比 |

#### Immersive Aircraft
| 标识符 | 返回值 | 说明 |
|--------|--------|------|
| `current_player_immersive_aircraft_durability` | 浮点数 / `false` | 当前乘坐飞机的耐久度（0~100） |
| `current_player_immersive_aircraft_engine` | 浮点数 / `false` | 当前乘坐飞机的引擎功率（0~1） |

#### NumismaticOverhaul
| 标识符 | 返回值 | 说明 |
|--------|--------|------|
| `current_player_numismaticoverhaul` | 数值 / `false` | 玩家货币数据，需指定 `type` 参数 |

**参数：**
- `type=bronze` — 返回铜币量（取个位十位）
- `type=silver` — 返回银币量（取百位千位）
- `type=gold` — 返回金币量（取万位以上）
- `type=all` — 返回总货币值（含所有币种换算）

用法示例：`{"placeholder":"current_player_numismaticoverhaul","type":"bronze"}`

### 原生 UI 隐藏

当启用某模组的联动功能后，可以自动隐藏该模组的原生 HUD 界面，避免界面重复显示。支持以下模组：

- Cold Sweat — 隐藏体温计 HUD
- Thirst Was Taken — 隐藏口渴值 HUD
- RealityValue — 隐藏健康值/理智值 HUD
- Immersive Aircraft — 隐藏飞机 HUD

## 配置

配置文件位于 `config/commandwithfmplaceholder-common.toml`。

```toml
[commands]
enableColdSweatCommand = true
enableThirstCommand = true
enableRealityValueCommand = true
enableNumismaticOverhaulCommand = true

[placeholders]
enableColdSweatPlaceholders = true
enableThirstPlaceholders = true
enableRealityValuePlaceholders = true
enableImmersiveAircraftPlaceholders = true
enableNumismaticOverhaulPlaceholders = true

[original_command_override]
disableRealityValueOriginalCommand = true
disableNumismaticOverhaulOriginalCommand = true

[hide_native_ui]
hideColdSweatNativeUI = true
hideThirstNativeUI = true
hideRealityValueNativeUI = true
hideImmersiveAircraftNativeUI = true

依赖

必需

• Minecraft 1.21.1
• NeoForge >= 21.1.228

可选

• FancyMenu >= 3.0 — 占位符功能
• Cold Sweat >= 2.0 — 体温联动
• Thirst Was Taken >= 1.21.1-2 — 口渴联动
• RealityValue >= 1.0 — 健康/理智联动
• Immersive Aircraft >= 1.0 — 飞机占位符
• NumismaticOverhaul >= 1.21.1-2 — 货币联动
• CmPlugins >= 1.0 — 额外兼容

所有依赖均为可选，未安装对应模组时相关功能自动禁用。