# Programming Farm Game

**Repository Path**: windRainCode/programming-farm-game

## Basic Information

- **Project Name**: Programming Farm Game
- **Description**: 编程农场游戏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 编程农场游戏

这是一个基于 Python 的农场游戏项目，旨在通过编程控制游戏中的各种操作，如种植、收获、移动等。项目提供了丰富的内置函数和工具函数，帮助玩家更好地进行游戏。

## 项目结构

- `__builtins__.py`: 定义了游戏中的各种类和函数，包括物品、实体、地面、解锁等功能。
- `tools.py`: 提供了一些工具函数，用于执行特定的游戏操作。
- `main.py`: 游戏的主程序文件。
- `save.json`: 保存游戏数据的文件。
- `.prettierignore`, `.prettierrc`, `.vscode/settings.json`: 与代码格式化和编辑器设置相关的配置文件。

## 主要功能

### 类定义

- `Item`, `Items`: 表示游戏中的物品及其集合。
- `Hat`, `Hats`: 表示帽子及其集合。
- `Leaderboard`, `Leaderboards`: 表示排行榜及其集合。
- `Entity`, `Entities`: 表示实体及其集合。
- `Ground`, `Grounds`: 表示地面类型及其集合。
- `Unlock`, `Unlocks`: 表示解锁功能及其集合。
- `Direction`: 表示方向。

### 核心函数

- `harvest()`, `can_harvest()`: 收割当前地块的作物。
- `plant(entity: Entity)`: 在当前地块种植指定的实体。
- `move(direction: Direction)`, `can_move(direction: Direction)`: 移动到指定方向的地块。
- `swap(direction: Direction)`: 与指定方向的地块交换位置。
- `till()`: 翻耕当前地块。
- `get_pos_x()`, `get_pos_y()`: 获取当前地块的坐标。
- `get_world_size()`: 获取世界大小。
- `get_entity_type()`: 获取当前地块的实体类型。
- `get_ground_type()`: 获取当前地块的地面类型。
- `get_time()`, `get_tick_count()`: 获取当前时间和游戏 ticks 数。
- `use_item(item: Item, n: 1)`: 使用指定数量的物品。
- `get_water()`: 获取当前水分。
- `do_a_flip()`, `pet_the_piggy()`: 特殊动作。
- `print(*something)`: 打印信息。
- `set_execution_speed(speed)`: 设置执行速度。
- `set_world_size(size)`: 设置世界大小。
- `num_items(item)`: 获取指定物品的数量。
- `get_cost(thing, level)`: 获取解锁或购买某物的成本。
- `clear()`: 清除当前地块的内容。
- `get_companion()`: 获取同伴信息。
- `unlock(unlock)`: 解锁指定功能。
- `num_unlocked(thing)`: 获取已解锁的数量。
- `measure(direction)`: 测量指定方向的距离。
- `leaderboard_run(leaderboard, file_name, speedup)`: 运行排行榜脚本。
- `simulate(...)`: 模拟游戏运行。
- `quick_print(*something)`: 快速打印信息。
- `random()`: 生成随机数。
- `len(obj)`, `range(start, stop, step)`, `str(obj)`, `min(*args)`, `max(*args)`, `abs(x)`: 常用内置函数。
- `change_hat(hat)`: 更换帽子。
- `spawn_drone(function)`, `wait_for(drone)`, `has_finished(drone)`, `max_drones()`, `num_drones()`: 无人机相关操作。

## 工具函数

- `do_hay()`: 收割草。
- `do_tree()`: 种植树木。
- `do_bush()`: 种植灌木。
- `do_pumpkin()`: 种植南瓜。
- `fix_pumpkin()`: 修复南瓜。
- `do_carrot()`: 种植胡萝卜。

## 使用方法

1. 确保已安装 Python 环境。
2. 克隆仓库到本地。
3. 运行 `main.py` 启动游戏。
4. 使用提供的函数和工具进行游戏操作。

## 贡献

欢迎提交 Pull Request 和 Issue 来帮助改进本项目。

## 许可证

本项目遵循 MIT 许可证。详情请查看仓库中的 LICENSE 文件。