EA SPORTS FC 27 Squads save editor with a Chinese Web interface, command-line tools, and Excel export.
EA SPORTS FC 27 Squads 存档编辑器，提供中文 Web 界面、命令行工具和 Excel 导出功能。
- 搜索球员：姓名、中文名或球员 ID / Search players by name, Chinese name, or player ID
- 按国籍、位置和总评筛选 / Filter by nationality, position, and overall rating
- 球员详情页在
data/heads/下有对应头像时显示头像，未匹配时显示姓名首字母（头像为 EA 素材，仓库不附带）/ Show player heads fromdata/heads/when present, with an initial fallback (head images are EA assets and are not bundled) - 修改总评、潜力、能力值、位置、角色、惯用脚、逆足、花式和身体数据（生日按
YYYY-MM-DD日期控件编辑）/ Edit ratings, potential, attributes, positions, roles, feet, skill moves, physical data, and birthdate as a real date - 修改普通特性和图标特性 / Edit regular and icon traits
- 查看球队阵容并批量修改球衣号码 / View squads and batch-edit shirt numbers
- 俱乐部、自由球员之间转会（自动识别 5v5/经理池占位球队，不出现在可选列表）/ Transfer players between clubs and free agents, with placeholder teams filtered out
- 国家队选拔：男足/女足切换，按国籍与名单性别筛选候选人（排除 5v5/经理池占位球员），按原名单人数原位改写（男足 26 人 / 女足 23 人）；支持「按位置自动编号（经典号码）」/ National squad selection with men/women switch, gender- and placeholder-aware candidates, roster-size-preserving in-place edits, and classic shirt-number auto assignment
- 快捷功能：全员年龄统一调整（保留真实月日，自动记录生日快照，可一键恢复原始/真实生日）/ Quick feature: set every player's age while keeping real month/day, with a reversible birthday snapshot
- 快捷功能：现役老将回归巅峰（FIFA19 峰值优先，FIFA19 没有的用 3DM 存档兜底，只升不降）/ Quick feature: restore active veterans to peak (FIFA19 first, 3DM fallback, raise-only)
- 快捷功能：从官方存档补齐真正缺失的球员（以自由球员加入，跳过同名换 ID 与占位记录）/ Quick feature: import genuinely missing players from an official save as free agents
- 快捷功能：一键添加当前存档缺失的传奇球员（默认男足，含 Kempes/Rivellino，写入真实生日与姓名行；女足传奇可选）/ Quick feature: add missing legends (men by default, including Kempes/Rivellino with real birthdays and name rows; women's legends optional)
- 打开存档：默认弹出系统文件选择窗口，失败时可用备用对话框按文件名/路径打开 / Open saves through the native file dialog, with a fallback dialog
- 导出球员表或完整存档数据到 Excel / Export player tables or complete save data to Excel
- Windows 10/11
- Python 3.10 或更高版本 / Python 3.10 or newer
- FC27 本地
Squads存档 / A local FC27Squadssave
在项目根目录双击 start_editor.bat。脚本会自动选择 Python，并安装缺少的依赖。
Double-click start_editor.bat in the project folder. It automatically selects Python and installs missing dependencies.
在项目目录打开 PowerShell，执行：
Open PowerShell in the project folder and run:
python -m pip install -r requirements.txt启动服务 / Start the service:
python web_app.py然后打开 / Then open:
http://127.0.0.1:8765/
启动时会自动加载 FC27 存档目录（settings）中修改时间最新的 Squads* 文件。也可以点击“打开存档”，直接用系统文件选择窗口打开任意存档。
At startup, the editor automatically loads the newest Squads* file from the FC27 settings folder. You can also click “打开存档” and pick any save in the native file dialog.
基本操作 / Basic workflow:
- 在“球员编辑”中搜索并选择球员。 / Search for and select a player in “球员编辑”.
- 修改字段，或选择球队、国家队和特性。 / Edit fields or select a club, national team, or trait.
- 点击“应用球员修改”。修改暂时只保存在内存中。 / Click “应用球员修改”. Changes remain in memory temporarily.
- 确认无误后点击“保存为新存档”。 / Click “保存为新存档” after reviewing the changes.
球队页面可以查看阵容并批量填写球衣号码。转会页面可以选择来源球队和目标球队，再点击球员对应的转会按钮。
“国家队选拔”页面支持男足/女足切换：按国籍和名单性别筛选候选人（自动排除 5v5/经理池占位记录），按原名单人数补满（男足 26 人 / 女足 23 人），可用“按位置自动编号（经典号码）”一键分号，点击“应用选拔与号码”后再点击顶部“保存为新存档”。
“快捷功能”页面提供四个批量操作：
- “全员年龄调整”：按目标年龄统一调整生日（保留真实月日，执行前自动记录生日快照，可恢复原始/内置真实生日）。
- “现役老将回归巅峰”：按 FIFA19 峰值恢复 30 岁以上现役老将，只升不降。
- “补齐缺失球员”：与官方存档对比，把真正缺失的球员以自由球员身份补回。
- “添加缺失传奇”：把传奇球员以自由球员身份补入（默认男足，女足传奇可选）。
所有操作都会先暂存修改，不会覆盖原存档；确认后点击顶部“保存为新存档”。再次点击“放弃修改”即可撤销尚未保存的操作。
The Teams page supports squad viewing and batch shirt-number editing. The Transfers page lets you select a source and target club, then transfer players individually.
The National Team page supports a men/women switch: candidates are filtered by nationality and roster gender (5v5/manager placeholder records are excluded), the squad is filled to the original roster size (26 for men, 23 for women), and “按位置自动编号（经典号码）” assigns classic shirt numbers. Apply the selection first, then click “Save as new save”.
The “Quick Features” page provides four batch actions:
- “全员年龄调整” — set every player's age while keeping their real month/day, with a reversible birthday snapshot.
- “现役老将回归巅峰” — restore active veterans (30+) to their FIFA19 peak values, raise-only.
- “补齐缺失球员” — import genuinely missing players from an official save as free agents.
- “添加缺失传奇” — add missing legends as free agents (men only by default; women's legends optional).
Everything is staged in memory first and the original save is never overwritten; click “保存为新存档” when ready, or “放弃修改” to discard the staged changes.
Both actions are staged in memory first. Click “Save as new save” when ready; click “Discard changes” to undo anything that has not been saved.
以下命令都在项目目录执行。请将示例路径替换为自己的 Squads 文件路径。
Run these commands from the project folder. Replace the example path with your own Squads save path.
# 查看存档摘要 / Show save summary
python main.py C:\path\to\Squads20260902010101
# 搜索球员 / Search players
python main.py C:\path\to\Squads... --search Messi
# 查看球员资料 / Show player details
python main.py C:\path\to\Squads... --player 158023
# 预览修改，不写入文件 / Preview changes without writing a file
python main.py C:\path\to\Squads... --set 158023 overallrating=99 finishing=99
# 修改并生成新的时间戳存档 / Apply changes and create a timestamped save
python main.py C:\path\to\Squads... --set 158023 overallrating=99 --save
# 修改并保存到指定的新文件 / Save to a new output file
python main.py C:\path\to\Squads... --set 158023 overallrating=99 --save-as boosted.sav
# 修改球员的球队和球衣号码 / Change a player's club and shirt number
python main.py C:\path\to\Squads... --set-team 158023 47 10 --save
# 修改特性：player_id bank bit on|off / Edit a trait bit
python main.py C:\path\to\Squads... --set-trait 158023 1 6 on --save
# 全员年龄调整（保留真实月日；默认 18 岁，可写 17/20 等）
python main.py C:\path\to\Squads... --set-age 18 --save
# 用生日快照恢复原始生日
python main.py C:\path\to\Squads... --restore-birthdays --save
# 用内置真实生日数据恢复
python main.py C:\path\to\Squads... --restore-real-birthdays --save
# 现役老将恢复巅峰（可用 --min-age / --min-peak 调整口径）
python main.py C:\path\to\Squads... --restore-peak --save
# 从官方存档补齐真正缺失的球员（以自由球员加入）
python main.py C:\path\to\Squads... --import-missing C:\path\to\OfficialSquads --save
# 导出 Excel / Export to Excel
python main.py C:\path\to\Squads... --export squad.xlsx
python main.py C:\path\to\Squads... --export-players players.xlsx常用字段 / Common fields:
overallrating, potential, finishing, dribbling, sprintspeed,
shotpower, ballcontrol, acceleration, agility, stamina, strength,
crossing, shortpassing, longpassing, volleys, composure,
preferredposition1, preferredfoot, weakfootabilitytypecode, skillmoves
字段也可以使用游戏内短名，例如 BAPc=4、aOBn=5。数值超出范围时会自动限制到有效范围；相对修改可以写成 overallrating=+5。
Fields may also use the in-game short names, such as BAPc=4 or aOBn=5. Values outside the valid range are clamped automatically; use overallrating=+5 for a relative change.
查看全部参数 / Show all options:
python main.py --help- FC27 存档球员 id = 公开 id + 1，球队内部 id = 资产 id + 2，自由球员内部 id 为
111594；高置信度球员映射见data/player_id_map.csv。 - 生日以「距 1582-10-14 的天数」存储；全员年龄功能保留真实月日、只改年份，并在
data/birthdate_snapshots/写入可恢复快照。 data/fifa19_peak.csv：FIFA19 峰值（公开 id），巅峰恢复的首选数据源。data/fc27_peak_fallback.csv：从 3DM 传奇档导出的峰值，FIFA19 没有的球员用这一份兜底（tools/build_fc27_peak_fallback.py可重建）。data/fc27_real_birthdays.csv：真实生日表（官方存档导出 + 传奇真实生日），tools/build_real_birthdays.py可重建。- 补齐缺失球员只补「真正缺失」：同名换 ID（FC27 id 偏移导致）和占位/自建记录会跳过；补回球员一律以自由球员身份加入。
- Web 界面和 CLI 的
--save会在原存档目录生成新的SquadsYYYYMMDDHHMMSS文件。 / The Web interface and CLI--savecreate a newSquadsYYYYMMDDHHMMSSfile in the original save folder. --save-as必须指定新的输出路径，程序不会覆盖已有文件。 /--save-asrequires a new output path and will not overwrite an existing file.- 原始存档不会被编辑器覆盖，仍建议先自行备份。 / The original save is not overwritten, but making a backup first is recommended.
- 保存完成后程序会自动重新读取并验证修改结果。 / The editor reloads and validates the result after saving.
点击顶部“打开存档”会直接弹出系统文件选择窗口；如果系统窗口不可用，把完整路径填进备用对话框。FC27 默认存档目录通常是：
Click “打开存档” to open the native file dialog. If it is unavailable, paste the full path into the fallback dialog. The default FC27 save folder is usually:
C:\Users\你的用户名\AppData\Local\EA SPORTS FC 27\settings\
文件名一般类似 Squads20260902010101。 / A typical filename looks like Squads20260902010101.
确认已安装 Python，并在项目目录执行：
Make sure Python is installed, then run this from the project folder:
python -m pip install -r requirements.txt确认启动窗口仍在运行，然后手动访问 http://127.0.0.1:8765/。关闭命令窗口会停止编辑器服务。
Keep the startup window open and visit http://127.0.0.1:8765/ manually. Closing the command window stops the editor service.
python -m unittest discover -s tests -v本项目的原创源代码和文档采用 Apache License 2.0 授权。
The original source code and documentation in this project are licensed under the Apache License 2.0.
仓库中随附的游戏衍生数据、数据库结构文件、球员姓名等资源可能受 EA 或其他权利人的版权及使用条款约束；Apache License 2.0 不转让这些第三方权利。球员头像等 EA 素材不随仓库分发。
Bundled game-derived data, database schema files, player names, and other third-party materials may be subject to the copyrights and terms of their respective owners. Apache License 2.0 does not transfer those third-party rights. Player head images and other EA assets are not distributed with this repository.