darksouls

该数据集是we6jbo Dark Souls 文本/示意图模拟器的公开访客接口，提供模拟器当前角色的完整存档数据。数据以 JSON、Markdown 和 JSONL 格式发布，包含角色属性（魂量、等级、属性、人性、契约）、当前区域、周目数、装备（武器、防具、戒指）、完整背包、钥匙及进度相关物品。此外，还提供角色历史快照（character-sheet-history.jsonl）和访客体验记录（guest-experience-history.jsonl），可用于分析角色随时间的变化。接口清单文件（interface.json、ports.json）定义了公开端口角色。数据集每日自动更新两次（太平洋时间 6:15 AM 和 8:45 PM），无需认证即可通过 HTTP 访问。适用于角色数据可视化、统计工具、RAG/LLM 上下文注入、派生数据集构建等场景。数据集不包含任何私有信息（如 IP 地址、凭证、API 密钥等）。This dataset is a public visitor interface for the we6jbo Dark Souls text/schematic simulator, providing complete save data for the simulators current character. The data is published in JSON, Markdown, and JSONL formats, including character attributes (souls, level, stats, humanity, covenant), current area, playthrough number, equipment (weapons, armor, rings), full inventory, keys, and progression-related items. Additionally, it provides character-sheet-history.jsonl and guest-experience-history.jsonl for analyzing changes over time. Interface files (interface.json, ports.json) define publicly accessible characters. The dataset is automatically updated twice daily (Pacific Time 6:15 AM and 8:45 PM) and accessible via HTTP without authentication. Suitable for character data visualization, statistics tools, RAG/LLM context injection, derived dataset construction, etc. The dataset contains no private information (e.g., IP addresses, credentials, API keys).

原始信息汇总

数据集概述

we6jbo Dark Souls Character / Guest Interface 是一个公开的 Hugging Face 数据集，作为 we6jbo Dark Souls 文本/示意图模拟器的未认证 Guest 接口。该数据集面向人类用户和 AI 系统，提供《黑暗之魂：重制版》角色数据的结构化访问。

基本信息

• 许可证：GPL-3.0
• 语言：英语
• 标签：dark-souls、dark-souls-remastered、character、simulator、dataset、ai、llm
• 项目主页：https://we6jbo.github.io/dark-souls-remastered-1.0.3-we6jbo-save/
• GitHub 仓库：https://github.com/we6jbo/dark-souls-remastered-1.0.3-we6jbo-save

主要文件

文件	说明
interface.json	机器可读的接口/发现清单
ports.json	公共接口端口角色定义
current-character.json	完整当前角色存档（JSON）
current-character.md	人类/LLM 可读的角色表（Markdown）
current-character.jsonl	当前角色的单条 JSONL 记录
character-sheet-history.jsonl	每次计划性角色发布记录
guest-experience-history.jsonl	Guest 读取回放体验记录
llms.txt	面向 LLM/检索系统的简要发现说明

公共端口

• 54224：Chrome 扩展通信端口，用于主控制器与 Chrome 扩展之间的通信
• 33315：主控制器与未来独立 bash Guest/HF 客户端之间的保留接口

主要用途

1. 以 JSON 格式拉取当前完整的角色表
2. 无需编写代码即可通过 Markdown 阅读角色信息
3. 查看灵魂数、等级、属性、人性、誓约、当前区域和 NG 周目
4. 查看装备的武器/防具/戒指及完整物品栏
5. 查看钥匙及其他进度相关物品
6. 将离线复制档案作为角色/统计工具的结构化输入
7. 基于角色 JSON 构建图表或仪表板
8. 对比计划快照/历史以研究角色随时间的变化
9. 将公共 JSON/Markdown 作为项目上下文输入本地 RAG 或 LLM 系统
10. 构建嵌入、分类或摘要等衍生公共数据集
11. 根据文档化的 54224/33315 端口角色验证集成
12. 通过 Hugging Face Discussions 提出公共安全改进或衍生工作

发布计划

模拟器每天在太平洋时间约上午 6:15 和下午 8:45 发布/补充当前角色表（需 GUI 有网络连接）。若计算机/GUI 在预定时间未运行，下一次调度周期会执行当天的补发。

成本与隐私

• Hugging Face 托管推理保持禁用，仅使用公开 Hub/数据集功能
• HF 授权支出：$0
• 全项目硬性支出上限：$34
• 游戏角色数据和文档化的接口端口角色为公开内容；凭证、API 密钥/令牌、私有 IP、主机名、MAC 地址、精确物理位置及私人手稿文本均被排除在外

搜集汇总

数据集介绍

构建方式

该数据集依托《黑暗之魂》重制版游戏环境中的角色模拟系统而构建，通过公开的Hugging Face数据集接口提供未经身份验证的访客访问通道。数据采集由we6jbo暗黑之魂文本/示意图模拟器自动完成，以每日约6:15 AM和8:45 PM太平洋时间的定时发布机制，将当前角色档案、装备配置、属性数值及进度信息序列化为JSON与Markdown格式，并记录每次预定发布尝试与访客读取经验，形成可追溯的历史记录。

特点

数据集以结构化与可读性并重的方式呈现角色状态，涵盖灵魂数量、等级、属性、人性、誓约、当前区域、周目循环、已装备武器防具戒指及完整物品栏等核心信息。其特色在于同时提供JSON、JSONL、Markdown等多种格式，并包含接口清单、端口角色说明及面向LLM的检索指南。公开端口54224与33315分别对应Chrome扩展通信和未来独立客户端预留接口，且排除了凭据、API令牌、私有IP等敏感数据，确保公开安全。

使用方法

使用者无需Hugging Face账户即可通过直接链接拉取current-character.json或Markdown文件，利用curl命令或Python的urlopen函数读取并解析角色数据。开发者可将JSON输出作为角色/属性工具的离线复制输入，或构建图表仪表盘以可视化数值变化；亦可对比历史快照研究角色成长轨迹，或将公开JSON与Markdown作为本地RAG及LLM系统的项目上下文，进而生成嵌入、分类与摘要等衍生数据集，并依据文档化的端口角色验证集成方案。

背景与挑战

背景概述

在电子游戏文化日益数据化的背景下，魂系游戏《黑暗之魂：重制版》以其高难度与复杂角色成长系统著称。we6jbo Dark Souls Character / Guest Interface数据集由开发者we6jbo创建，托管于Hugging Face平台，旨在为公众与AI系统提供未经身份验证的访客接口，以结构化方式访问游戏角色存档。该数据集于2024年前后发布，核心研究问题在于将游戏内角色状态、装备、进度等元数据转化为机器可读的JSON与Markdown格式，并借助端口角色文档保障接口安全。其影响力体现在为游戏数据科学、本地RAG系统及角色模拟工具提供了可复用的基准资源，推动了游戏存档分析与AI集成研究。

当前挑战

该数据集所服务的领域问题在于游戏角色状态的动态追踪与跨平台互操作，即如何将封闭游戏环境中的实时存档可靠地映射为公开可解析的数据流。构建过程中面临多重挑战：其一，游戏存档格式的私有性与版本更新导致的结构漂移，要求解析器具备鲁棒性；其二，在仅暴露公共端口与零授权开销的约束下，确保数据发布不泄露凭证、私网IP等敏感信息；其三，定时发布机制受GUI运行状态制约，可能造成数据缺失与历史快照不一致；其四，维持人类可读与机器可读两种表征的语义对齐，避免LLM误读或幻觉。这些挑战共同构成了游戏数据开放化进程中的典型难题。

常用场景

经典使用场景

在电子游戏数据科学与交互式叙事研究领域，该数据集作为《黑暗之魂》角色状态的公开快照源，其经典使用场景在于为研究者与爱好者提供结构化的角色档案访问接口。通过解析current-character.json等文件，用户能够系统性地获取角色灵魂数量、等级、属性、人性、誓约、当前区域及周目等核心状态参数，亦可审视装备与库存详情。这一设计使得离线分析、进度追踪与跨平台数据比对成为可能，构成了游戏状态数据化研究的典型范例。

实际应用

在实际应用层面，该数据集服务于多类场景：游戏工具开发者可将其作为角色规划器与统计仪表板的数据后端；本地检索增强生成系统与大型语言模型可将其作为项目上下文，实现角色状态的自然语言查询与摘要生成；社区成员亦能基于公开JSON构建衍生数据集，用于嵌入向量训练或分类任务。此外，该接口还支持对Chrome扩展通信端口与预留端口关系的验证，为集成测试提供基准。

衍生相关工作

围绕该数据集已衍生出一系列相关工作，包括基于current-character.json构建的角色属性可视化面板、利用character-sheet-history.jsonl进行的进度时间序列分析，以及将Markdown格式角色表接入本地RAG系统以生成叙事性摘要的尝试。公开端口角色文档亦催生了针对54224与33315接口的集成验证工具，而llms.txt的提供则促进了面向检索系统的轻量化发现协议实践，形成了从数据消费到工具构建的生态链条。