MoreWeapons

# 更多的武器（一）/ More Weapons (Part I)

## 概述 / Overview

该模组为 Stoneshard (0. 9. 4. 25) 新增 7 把近战武器（贴合世界观风格）：

This mod adds 7 lore-friendly melee weapons to Stoneshard (0. 9. 4. 22):

- 5 把长杆武器 / 5 polearms

- 2 把单手锤棒 / 2 one-handed maces

目标是在不破坏原版掉落逻辑的前提下，补充物理系武器成长曲线。

The goal is to expand progression options for physical builds while staying integrated with vanilla loot systems.

## 新增武器 / Added Weapons

### 普通品质成长武器 / Normal Progression Weapons

- Training Spear

- Dingtou Spear

- Nuxian Spear

### 独一无二武器 / Unique Weapons

- Denuxiya Spear

- Fangtian Ji

- Duer Morningstar

- Qiliya Warhammer

## 掉落整合 / Loot Integration

- 普通武器接入原版标准装备池。

- Normal weapons are integrated into vanilla equipment pools.

- 独一无二武器保留 unique 行为，并可在高价值后期场景中出现。

- Unique weapons keep unique behavior and can appear in high-value late-game loot contexts.

- 远程 boss 宝箱脚本增加了额外的 unique 掷骰分支。

- Remote boss chest scripts include an additional unique-roll branch.

## 技术说明 / Technical Notes

- 适配游戏版本：Stoneshard 0. 9. 4. 22。

- Target game version: Stoneshard 0. 9. 4. 22.

- 基于 ModShardLauncher 运行时注入。

- Built with ModShardLauncher runtime patching.

- 包含长杆武器精灵锚点微调，以改善角色持握显示。

- Includes polearm sprite anchor adjustments for better visual alignment.

## 平衡说明 / Balance Notes

- 普通武器价格已从早期测试值下调，更贴合成长节奏。

- Prices of normal weapons were tuned down from earlier test values to better fit progression pacing.

- 本模组不提供保底掉落，获取仍然是随机机制。

- This mod does not force guaranteed drops; acquisition remains RNG-based.

## 兼容性 / Compatibility

- 设计目标是与大多数内容向模组共存。

- Designed to coexist with most content mods.

- 若其他模组重写相同掉落脚本，最终掉落表现可能变化。

- Mods that heavily rewrite the same loot scripts may affect final drop behavior.

- 当多个模组修改同一函数时，加载顺序和注入顺序很重要。

- Load order and patch order can matter when multiple mods edit the same functions.

## 安装 / Installation

1. 安装 ModShardLauncher。

2. Install ModShardLauncher.

3. 按你的启动器流程，将本模组放入对应 ModSources/mods 目录。

4. Put this mod into your ModSources/mods path according to your launcher setup.

5. 按正常 MSL 工作流构建并启动。

6. Build and launch through your normal MSL workflow.

## 卸载 / Uninstallation

1. 从当前构建/启用列表中移除此模组。

2. Remove this mod from your active build or enabled list.

3. 重新构建模组包。

4. Rebuild your mod pack.

5. 旧存档中已生成的物品可能仍会保留。

6. Existing spawned items in old saves may remain.

## 已知问题 / Known Issues

- 若多个模组同时补丁相同掉落函数，实际概率可能偏离预期。

- If multiple mods patch identical loot functions, effective rates may differ from intended values.

- 在重度联包下，读档与 unique 类世界物品偶发边缘问题可能出现。

- In heavily mixed mod packs, rare edge cases with save/load and unique-like world items can occur.

## 致谢 / Credits

- 作者 / Author: 小毅

- 框架 / Framework: ModShardLauncher

## 使用许可 / Permissions

- 未经作者许可，请勿转载本模组或其修改版本。

- Do not reupload this mod or modified versions without the author's permission.

- 可在个人私用整合包中使用。

- You may include this mod in a private personal mod list.

## 更新日志 / Changelog

### 0. 1. 0

- 首个 Nexus 发布版本。

- Initial Nexus release.

- 新增 7 把武器（5 长杆 + 2 单手锤棒）。

- Added 7 weapons (5 polearms + 2 one-handed maces).

- 完成掉落逻辑整合与精灵锚点调整。

- Integrated loot logic updates and sprite anchor adjustments.