# 纯前端游戏-冒险村放置 - 放置挂机

**Repository Path**: xiaoyi1314/yellowjgame

## Basic Information

- **Project Name**: 纯前端游戏-冒险村放置 - 放置挂机
- **Description**: 召集四位冒险者，自动爬塔、拾取世界装与传说级装备，轻松放置、深度策略——《冒险村放置》把收集与成长完美融合，适合娱乐与学习。
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-27
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 游戏, 挂机, 放置

## README

# 地址：https://gitee.com/xiaoyi1314/yellowjgame

# 冒险村放置

放置挂机游戏 · 打造你的终极冒险队伍

立即打开 `index.html` 即可运行，适合玩家试玩与开发者学习。

---

## ✨ 一句话简介

召集四位冒险者，自动爬塔、拾取世界装与传说级装备，轻松放置、深度策略——《冒险村放置》把收集与成长完美融合，适合娱乐与学习。

---

## 游戏亮点

- 纯前端单文件运行：直接打开 `index.html` 即可体验，无需安装。适合教学、演示与二次开发。
- 放置与策略并重：挂机自动战斗 + 职业分工（牧师/法师/战士），既能轻松放置，又有策略深度。
- 世界装与顶级掉落：副本掉落独立标识为“世界装”，附带更高价值与词缀，收藏爽感十足。
- 丰富装备系统：词缀、套装、传奇/神话/彩虹（超神）等级，多维度影响战斗与成长。
- 自动智能：自动穿戴（职业套装优先）、自动使用药水、队伍自动运行副本，操作简单。
- 开源可学：代码注释清晰，`Config` 可调，易于扩展与平衡调整。

---

## 快速上手（本地运行）

推荐用本地静态服务器运行（避免部分浏览器的本地文件限制）：

在项目目录里打开 PowerShell，然后运行：

```powershell
# 在项目根目录运行（Windows PowerShell）
python -m http.server 8000
# 在浏览器打开： http://localhost:8000/index.html
```

或者直接双击 `index.html` 在浏览器打开（部分浏览器对本地文件可能有限制）。

---

## 新手玩法指南（30 秒上手）

1. 进入“冒险者”界面，招募并查看角色信息。
2. 从冒险者池中选择最多 4 人组成队伍，点击进入副本开始挂机爬塔。
3. 观察日志与掉落：副本会掉落更高级的“世界装”，自动尝试穿戴并提升实力。
4. 使用游戏内资源与装备强化队伍，重复挑战更高层数以获取更强战利品。

---

## 面向开发者的说明

- 主要文件：`index.html`（单文件实现，包含游戏逻辑与 UI）。
- 关键模块与入口：
  - `Config`：全局配置（稀有度、词缀、DUNGEON_CONFIG 等）。
  - `createEquipment(level, rarityIndex, slot)`：通用装备生成器。
  - `createDungeonEquipment(team, level)`：副本专属装备生成（带 floorBoost 与世界装标记）。
  - `processDungeonLoot(team, monster)`：处理掉落并分配到背包。
  - `_runDungeonStep(team)` / `startDungeonRun(team)`：副本运行器与单步战斗流程。
  - `calculateEquipmentValue(equipment)`、`calculateAdventurerPowerScore(adventurer)`：价值/实力计算。

---

## 调试与平衡工具

打开浏览器开发者工具（F12）→ Console，可直接调用内置调试函数：

- `game.debugCompareDungeonVsNormal(level, floor, trials)`：生成样本并对比“世界装 vs 普通装”属性与价值（level/floor/trials 可选）。
- `game.getRarityLabel(index)`：返回稀有度标签（例如 `彩虹（超神）`）。

## 如何调整副本掉率

当前副本掉率逻辑位于 `createDungeonEquipment(team, level)`，直接修改函数内的概率分支即可；建议更好的做法是把概率表提取到 `Config`（例如 `Config.DUNGEON_CONFIG.RARITY_DISTRIBUTION`），这样后续可以无代码修改地调整平衡。

---

## 设计亮点与学习价值

- 清晰的数值计算（避免 NaN 的保护措施）。
- 可配置的装备与掉落系统，便于做游戏性试验与平衡。
- 核心流程（创造/掉落/穿戴/评分）的函数化设计，适合用作前端游戏教学案例。

---

## 宣传语与推广

> 组建你的四人探险队，爬塔夺取传说级装备——《冒险村放置》，挂机也能成王！

## 祝福

> **愿你的代码如诗般优雅，bug永远为零，创意无限，在编程的世界里，织就属于你的星辰大海**