@arcadia-eternity/data-pack-base 0.0.0-stage → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (284) hide show
  1. package/DATA_README.md +48 -0
  2. package/LICENSE +21 -0
  3. package/PACK_FORMAT.md +93 -0
  4. package/assets/bingchuantun/marks/hanbingjianren.png +0 -0
  5. package/assets/bingchuantun/pets/bingchuantun-icon.png +0 -0
  6. package/assets/bingchuantun/pets/bingchuantun-portrait.png +0 -0
  7. package/assets/bingchuantun/pets/binghutun-icon.png +0 -0
  8. package/assets/bingchuantun/pets/binghutun-portrait.png +0 -0
  9. package/assets/bingchuantun/pets/tuntun-icon.png +0 -0
  10. package/assets/bingchuantun/pets/tuntun-portrait.png +0 -0
  11. package/content-groups.yaml +593 -0
  12. package/data/groups/abao/species.0044.yaml +117 -0
  13. package/data/groups/aika/species.0064.yaml +117 -0
  14. package/data/groups/ailu/species.0037.yaml +117 -0
  15. package/data/groups/aixi/species.0051.yaml +117 -0
  16. package/data/groups/aka/species.0011.yaml +117 -0
  17. package/data/groups/anke/species.0009.yaml +159 -0
  18. package/data/groups/anyite/species.0026.yaml +75 -0
  19. package/data/groups/bingchuantun/species.0071.yaml +160 -0
  20. package/data/groups/bingyite/species.0025.yaml +76 -0
  21. package/data/groups/buer/species.0005.yaml +117 -0
  22. package/data/groups/chilunying/species.0045.yaml +118 -0
  23. package/data/groups/chongyite/species.0062.yaml +70 -0
  24. package/data/groups/dada/species.0050.yaml +159 -0
  25. package/data/groups/daerhou/species.0019.yaml +159 -0
  26. package/data/groups/dianyite/species.0024.yaml +76 -0
  27. package/data/groups/dilan/species.0000.yaml +163 -0
  28. package/data/groups/dongqigui/species.0056.yaml +117 -0
  29. package/data/groups/duoli/species.0057.yaml +117 -0
  30. package/data/groups/duomo/species.0029.yaml +117 -0
  31. package/data/groups/fala/species.0003.yaml +159 -0
  32. package/data/groups/feiya/species.0036.yaml +117 -0
  33. package/data/groups/feiyite/species.0060.yaml +70 -0
  34. package/data/groups/fenfen/species.0067.yaml +141 -0
  35. package/data/groups/fengyite/species.0023.yaml +76 -0
  36. package/data/groups/gexike/species.0032.yaml +117 -0
  37. package/data/groups/guangyite/species.0027.yaml +75 -0
  38. package/data/groups/gusi/species.0008.yaml +159 -0
  39. package/data/groups/huanhuan/species.0065.yaml +114 -0
  40. package/data/groups/huoke/species.0014.yaml +117 -0
  41. package/data/groups/jiujiu/species.0017.yaml +159 -0
  42. package/data/groups/kadundudu/species.0070.yaml +134 -0
  43. package/data/groups/kaisa/species.0055.yaml +66 -0
  44. package/data/groups/kaluo/species.0035.yaml +117 -0
  45. package/data/groups/kate/species.0034.yaml +117 -0
  46. package/data/groups/laao/species.0002.yaml +159 -0
  47. package/data/groups/lanmiao/species.0010.yaml +117 -0
  48. package/data/groups/leike/species.0039.yaml +180 -0
  49. package/data/groups/leiyi/species.0054.yaml +66 -0
  50. package/data/groups/linna/species.0052.yaml +105 -0
  51. package/data/groups/maimaizi/species.0020.yaml +159 -0
  52. package/data/groups/mogu/species.0030.yaml +117 -0
  53. package/data/groups/naipu/species.0053.yaml +101 -0
  54. package/data/groups/nigu/species.0040.yaml +192 -0
  55. package/data/groups/niuniu/species.0048.yaml +105 -0
  56. package/data/groups/palading/species.0069.yaml +126 -0
  57. package/data/groups/pige/species.0059.yaml +117 -0
  58. package/data/groups/qilu/species.0007.yaml +117 -0
  59. package/data/groups/salan/species.0046.yaml +118 -0
  60. package/data/groups/sanyanxie/species.0042.yaml +117 -0
  61. package/data/groups/saobatou/species.0058.yaml +159 -0
  62. package/data/groups/sasa/species.0068.yaml +141 -0
  63. package/data/groups/shasha/species.0066.yaml +117 -0
  64. package/data/groups/shayite/species.0061.yaml +70 -0
  65. package/data/groups/shazhihe/species.0031.yaml +117 -0
  66. package/data/groups/shuimodian/species.0016.yaml +117 -0
  67. package/data/groups/taimu/species.0047.yaml +117 -0
  68. package/data/groups/tangni/species.0028.yaml +156 -0
  69. package/data/groups/wuda/species.0049.yaml +117 -0
  70. package/data/groups/xiaoba/species.0041.yaml +105 -0
  71. package/data/groups/xiaochitun/species.0015.yaml +117 -0
  72. package/data/groups/xiaoshugen/species.0006.yaml +117 -0
  73. package/data/groups/xiaoxiaokui/species.0004.yaml +159 -0
  74. package/data/groups/xiaoyanfu/species.0013.yaml +159 -0
  75. package/data/groups/xiaoyuetu/species.0018.yaml +117 -0
  76. package/data/groups/xijie/species.0021.yaml +117 -0
  77. package/data/groups/xiuxiu/species.0001.yaml +159 -0
  78. package/data/groups/yilu/species.0043.yaml +117 -0
  79. package/data/groups/yingguangdie/species.0038.yaml +117 -0
  80. package/data/groups/yite/species.0022.yaml +42 -0
  81. package/data/groups/youni/species.0012.yaml +117 -0
  82. package/data/groups/zhanyite/species.0063.yaml +75 -0
  83. package/data/groups/zhikejji/species.0033.yaml +159 -0
  84. package/data/mark.yaml +2810 -0
  85. package/data/mark_ability.yaml +392 -0
  86. package/data/mark_emblem.yaml +378 -0
  87. package/data/mark_global.yaml +56 -0
  88. package/data/presentations/main.yaml +8847 -0
  89. package/data/resources/main.yaml +5862 -0
  90. package/data/skill.yaml +11823 -0
  91. package/dist/THIRD_PARTY_NOTICES.md +157 -0
  92. package/dist/arcadia-effects.json +1 -0
  93. package/dist/catalog.json +1 -0
  94. package/dist/content.json +1 -0
  95. package/dist/effects.js +13325 -0
  96. package/dist/environment-build.json +5 -0
  97. package/dist/environment-runtime.mjs +35552 -0
  98. package/dist/metadata.d.ts +6 -0
  99. package/dist/metadata.mjs +6 -0
  100. package/dist/native-build.d.ts +1 -0
  101. package/dist/native-build.mjs +1 -0
  102. package/dist/presentation.json +1 -0
  103. package/dist/types/effects.d.ts +80 -0
  104. package/dist/types/effects.d.ts.map +1 -0
  105. package/dist/types/src/content.d.ts +6 -0
  106. package/dist/types/src/content.d.ts.map +1 -0
  107. package/dist/types/src/effect-mark-relations.d.ts +7 -0
  108. package/dist/types/src/effect-mark-relations.d.ts.map +1 -0
  109. package/dist/types/src/effects/attribute-contributions.generated.d.ts +48 -0
  110. package/dist/types/src/effects/attribute-contributions.generated.d.ts.map +1 -0
  111. package/dist/types/src/effects/authored/damage-by-hp.d.ts +4 -0
  112. package/dist/types/src/effects/authored/damage-by-hp.d.ts.map +1 -0
  113. package/dist/types/src/effects/authored/fantasy-defense.d.ts +4 -0
  114. package/dist/types/src/effects/authored/fantasy-defense.d.ts.map +1 -0
  115. package/dist/types/src/effects/authored/index.d.ts +14 -0
  116. package/dist/types/src/effects/authored/index.d.ts.map +1 -0
  117. package/dist/types/src/effects/authored/time-rebirth.d.ts +4 -0
  118. package/dist/types/src/effects/authored/time-rebirth.d.ts.map +1 -0
  119. package/dist/types/src/effects/authored/weakness-speed.d.ts +10 -0
  120. package/dist/types/src/effects/authored/weakness-speed.d.ts.map +1 -0
  121. package/dist/types/src/effects/automatic-stack-consumption.d.ts +7 -0
  122. package/dist/types/src/effects/automatic-stack-consumption.d.ts.map +1 -0
  123. package/dist/types/src/effects/bingchuantun.d.ts +45 -0
  124. package/dist/types/src/effects/bingchuantun.d.ts.map +1 -0
  125. package/dist/types/src/effects/candidate-catalog.d.ts +11 -0
  126. package/dist/types/src/effects/candidate-catalog.d.ts.map +1 -0
  127. package/dist/types/src/effects/compound-actions.generated.d.ts +40 -0
  128. package/dist/types/src/effects/compound-actions.generated.d.ts.map +1 -0
  129. package/dist/types/src/effects/conditional-actions.generated.d.ts +30 -0
  130. package/dist/types/src/effects/conditional-actions.generated.d.ts.map +1 -0
  131. package/dist/types/src/effects/consecutive-flying-rage.d.ts +3 -0
  132. package/dist/types/src/effects/consecutive-flying-rage.d.ts.map +1 -0
  133. package/dist/types/src/effects/consecutive-healing.d.ts +8 -0
  134. package/dist/types/src/effects/consecutive-healing.d.ts.map +1 -0
  135. package/dist/types/src/effects/context-controls.generated.d.ts +16 -0
  136. package/dist/types/src/effects/context-controls.generated.d.ts.map +1 -0
  137. package/dist/types/src/effects/curse-mark-application.d.ts +5 -0
  138. package/dist/types/src/effects/curse-mark-application.d.ts.map +1 -0
  139. package/dist/types/src/effects/damage-benefits.d.ts +8 -0
  140. package/dist/types/src/effects/damage-benefits.d.ts.map +1 -0
  141. package/dist/types/src/effects/damage-modifiers.generated.d.ts +212 -0
  142. package/dist/types/src/effects/damage-modifiers.generated.d.ts.map +1 -0
  143. package/dist/types/src/effects/damage-sequences.generated.d.ts +36 -0
  144. package/dist/types/src/effects/damage-sequences.generated.d.ts.map +1 -0
  145. package/dist/types/src/effects/damage-thresholds.generated.d.ts +16 -0
  146. package/dist/types/src/effects/damage-thresholds.generated.d.ts.map +1 -0
  147. package/dist/types/src/effects/double-stage-debuff.d.ts +4 -0
  148. package/dist/types/src/effects/double-stage-debuff.d.ts.map +1 -0
  149. package/dist/types/src/effects/dynamic-contributions.generated.d.ts +26 -0
  150. package/dist/types/src/effects/dynamic-contributions.generated.d.ts.map +1 -0
  151. package/dist/types/src/effects/emblem-skill-cost.d.ts +4 -0
  152. package/dist/types/src/effects/emblem-skill-cost.d.ts.map +1 -0
  153. package/dist/types/src/effects/event-cancellation.generated.d.ts +26 -0
  154. package/dist/types/src/effects/event-cancellation.generated.d.ts.map +1 -0
  155. package/dist/types/src/effects/execute-low-health.d.ts +5 -0
  156. package/dist/types/src/effects/execute-low-health.d.ts.map +1 -0
  157. package/dist/types/src/effects/experience-placeholder.d.ts +4 -0
  158. package/dist/types/src/effects/experience-placeholder.d.ts.map +1 -0
  159. package/dist/types/src/effects/fractional-healing.d.ts +8 -0
  160. package/dist/types/src/effects/fractional-healing.d.ts.map +1 -0
  161. package/dist/types/src/effects/heal-modifiers.d.ts +17 -0
  162. package/dist/types/src/effects/heal-modifiers.d.ts.map +1 -0
  163. package/dist/types/src/effects/healing.d.ts +8 -0
  164. package/dist/types/src/effects/healing.d.ts.map +1 -0
  165. package/dist/types/src/effects/ignore-shield.generated.d.ts +8 -0
  166. package/dist/types/src/effects/ignore-shield.generated.d.ts.map +1 -0
  167. package/dist/types/src/effects/instant-literals.generated.d.ts +20 -0
  168. package/dist/types/src/effects/instant-literals.generated.d.ts.map +1 -0
  169. package/dist/types/src/effects/kadundudu.d.ts +40 -0
  170. package/dist/types/src/effects/kadundudu.d.ts.map +1 -0
  171. package/dist/types/src/effects/last-stand.d.ts +6 -0
  172. package/dist/types/src/effects/last-stand.d.ts.map +1 -0
  173. package/dist/types/src/effects/mark-application-settings.generated.d.ts +40 -0
  174. package/dist/types/src/effects/mark-application-settings.generated.d.ts.map +1 -0
  175. package/dist/types/src/effects/mark-applications.generated.d.ts +288 -0
  176. package/dist/types/src/effects/mark-applications.generated.d.ts.map +1 -0
  177. package/dist/types/src/effects/mark-consumption.generated.d.ts +20 -0
  178. package/dist/types/src/effects/mark-consumption.generated.d.ts.map +1 -0
  179. package/dist/types/src/effects/mark-removals.generated.d.ts +32 -0
  180. package/dist/types/src/effects/mark-removals.generated.d.ts.map +1 -0
  181. package/dist/types/src/effects/mark-stack-gains.generated.d.ts +10 -0
  182. package/dist/types/src/effects/mark-stack-gains.generated.d.ts.map +1 -0
  183. package/dist/types/src/effects/mark-transfers.d.ts +8 -0
  184. package/dist/types/src/effects/mark-transfers.d.ts.map +1 -0
  185. package/dist/types/src/effects/multihit.generated.d.ts +42 -0
  186. package/dist/types/src/effects/multihit.generated.d.ts.map +1 -0
  187. package/dist/types/src/effects/named-parameters.d.ts +8 -0
  188. package/dist/types/src/effects/named-parameters.d.ts.map +1 -0
  189. package/dist/types/src/effects/palading.d.ts +72 -0
  190. package/dist/types/src/effects/palading.d.ts.map +1 -0
  191. package/dist/types/src/effects/rage-assignment.generated.d.ts +14 -0
  192. package/dist/types/src/effects/rage-assignment.generated.d.ts.map +1 -0
  193. package/dist/types/src/effects/rage-gain-limit.d.ts +3 -0
  194. package/dist/types/src/effects/rage-gain-limit.d.ts.map +1 -0
  195. package/dist/types/src/effects/rage-modifiers.generated.d.ts +12 -0
  196. package/dist/types/src/effects/rage-modifiers.generated.d.ts.map +1 -0
  197. package/dist/types/src/effects/rage.d.ts +9 -0
  198. package/dist/types/src/effects/rage.d.ts.map +1 -0
  199. package/dist/types/src/effects/rain-water-shield.d.ts +5 -0
  200. package/dist/types/src/effects/rain-water-shield.d.ts.map +1 -0
  201. package/dist/types/src/effects/random-mark-applications.d.ts +8 -0
  202. package/dist/types/src/effects/random-mark-applications.d.ts.map +1 -0
  203. package/dist/types/src/effects/random-skill.d.ts +7 -0
  204. package/dist/types/src/effects/random-skill.d.ts.map +1 -0
  205. package/dist/types/src/effects/random-stat-actions.d.ts +8 -0
  206. package/dist/types/src/effects/random-stat-actions.d.ts.map +1 -0
  207. package/dist/types/src/effects/random-temporary-effect.d.ts +6 -0
  208. package/dist/types/src/effects/random-temporary-effect.d.ts.map +1 -0
  209. package/dist/types/src/effects/random-weather-application.d.ts +6 -0
  210. package/dist/types/src/effects/random-weather-application.d.ts.map +1 -0
  211. package/dist/types/src/effects/resource-prevention.d.ts +6 -0
  212. package/dist/types/src/effects/resource-prevention.d.ts.map +1 -0
  213. package/dist/types/src/effects/shared-plans.d.ts +17 -0
  214. package/dist/types/src/effects/shared-plans.d.ts.map +1 -0
  215. package/dist/types/src/effects/shield.d.ts +11 -0
  216. package/dist/types/src/effects/shield.d.ts.map +1 -0
  217. package/dist/types/src/effects/skill-contributions.generated.d.ts +34 -0
  218. package/dist/types/src/effects/skill-contributions.generated.d.ts.map +1 -0
  219. package/dist/types/src/effects/skill-disabling.generated.d.ts +14 -0
  220. package/dist/types/src/effects/skill-disabling.generated.d.ts.map +1 -0
  221. package/dist/types/src/effects/skill-flags.generated.d.ts +18 -0
  222. package/dist/types/src/effects/skill-flags.generated.d.ts.map +1 -0
  223. package/dist/types/src/effects/skill-numeric-references.generated.d.ts +22 -0
  224. package/dist/types/src/effects/skill-numeric-references.generated.d.ts.map +1 -0
  225. package/dist/types/src/effects/skill-outcome-sequences.generated.d.ts +30 -0
  226. package/dist/types/src/effects/skill-outcome-sequences.generated.d.ts.map +1 -0
  227. package/dist/types/src/effects/skill-outcomes.generated.d.ts +136 -0
  228. package/dist/types/src/effects/skill-outcomes.generated.d.ts.map +1 -0
  229. package/dist/types/src/effects/skill-power.generated.d.ts +214 -0
  230. package/dist/types/src/effects/skill-power.generated.d.ts.map +1 -0
  231. package/dist/types/src/effects/skill-transformation.d.ts +6 -0
  232. package/dist/types/src/effects/skill-transformation.d.ts.map +1 -0
  233. package/dist/types/src/effects/stack-damage.d.ts +7 -0
  234. package/dist/types/src/effects/stack-damage.d.ts.map +1 -0
  235. package/dist/types/src/effects/stack-trigger-probability.d.ts +6 -0
  236. package/dist/types/src/effects/stack-trigger-probability.d.ts.map +1 -0
  237. package/dist/types/src/effects/stat-stage-clears.generated.d.ts +28 -0
  238. package/dist/types/src/effects/stat-stage-clears.generated.d.ts.map +1 -0
  239. package/dist/types/src/effects/stat-stage-sequences.generated.d.ts +28 -0
  240. package/dist/types/src/effects/stat-stage-sequences.generated.d.ts.map +1 -0
  241. package/dist/types/src/effects/stat-stages.generated.d.ts +110 -0
  242. package/dist/types/src/effects/stat-stages.generated.d.ts.map +1 -0
  243. package/dist/types/src/effects/switch-rage-protection.d.ts +3 -0
  244. package/dist/types/src/effects/switch-rage-protection.d.ts.map +1 -0
  245. package/dist/types/src/effects/tagged-parameters.d.ts +10 -0
  246. package/dist/types/src/effects/tagged-parameters.d.ts.map +1 -0
  247. package/dist/types/src/effects/vital-actions.generated.d.ts +98 -0
  248. package/dist/types/src/effects/vital-actions.generated.d.ts.map +1 -0
  249. package/dist/types/src/effects/vital-sequences.generated.d.ts +44 -0
  250. package/dist/types/src/effects/vital-sequences.generated.d.ts.map +1 -0
  251. package/dist/types/src/effects/water-shield-content.d.ts +11 -0
  252. package/dist/types/src/effects/water-shield-content.d.ts.map +1 -0
  253. package/dist/types/src/effects/weakness-transfer.d.ts +4 -0
  254. package/dist/types/src/effects/weakness-transfer.d.ts.map +1 -0
  255. package/dist/types/src/effects/weight-damage.d.ts +8 -0
  256. package/dist/types/src/effects/weight-damage.d.ts.map +1 -0
  257. package/dist/types/src/templates/combat.d.ts +2 -0
  258. package/dist/types/src/templates/combat.d.ts.map +1 -0
  259. package/dist/types/src/templates/contracts.d.ts +49 -0
  260. package/dist/types/src/templates/contracts.d.ts.map +1 -0
  261. package/dist/types/src/templates/index.d.ts +42 -0
  262. package/dist/types/src/templates/index.d.ts.map +1 -0
  263. package/dist/types/src/templates/marks.d.ts +2 -0
  264. package/dist/types/src/templates/marks.d.ts.map +1 -0
  265. package/dist/types/src/templates/resources.d.ts +2 -0
  266. package/dist/types/src/templates/resources.d.ts.map +1 -0
  267. package/dist/types/tsconfig.tsbuildinfo +1 -0
  268. package/locales/en/mark.yaml +5 -0
  269. package/locales/en/mark_ability.yaml +3 -0
  270. package/locales/en/mark_emblem.yaml +3 -0
  271. package/locales/en/skill.yaml +39 -0
  272. package/locales/en/species.yaml +10 -0
  273. package/locales/zh-CN/battle.yaml +67 -0
  274. package/locales/zh-CN/mark.yaml +771 -0
  275. package/locales/zh-CN/mark_ability.yaml +219 -0
  276. package/locales/zh-CN/mark_emblem.yaml +216 -0
  277. package/locales/zh-CN/mark_global.yaml +21 -0
  278. package/locales/zh-CN/nature.yaml +51 -0
  279. package/locales/zh-CN/skill.yaml +3026 -0
  280. package/locales/zh-CN/species.yaml +456 -0
  281. package/locales/zh-CN/webui.yaml +183 -0
  282. package/pack.json +94 -0
  283. package/package.json +72 -3
  284. package/README.md +0 -3
package/DATA_README.md ADDED
@@ -0,0 +1,48 @@
1
+ # 数据包
2
+
3
+ ## 关于命名规范
4
+
5
+ ### 内容文件
6
+
7
+ 精灵种族保存在 `data/groups/<group>/species.*.yaml`;技能保存在 `data/skill.yaml`,印记保存在 `data/mark*.yaml`。`pack.json` 指定读取文件及顺序,编辑器按实际来源文件保存修改。
8
+
9
+ 效果行为以 `src/effects/` 中的 TypeScript 为准;技能和印记的 `effect` 字段继续通过稳定 ID 引用效果。旧效果 YAML 只作为回归测试夹具保留,不随基础内容包分发。
10
+
11
+ 种族、技能和印记的命名约定如下。
12
+
13
+ ### 效果以外的对象
14
+
15
+ 类型[_子类型]*名称[*附加信息/派生形态]
16
+
17
+ 其中名称为原对象的中文名的拼音缩写,仅使用 小写字母、数字、下划线。
18
+
19
+ ```example:plaintext
20
+ pet_dilante #精灵-迪兰特
21
+ pet_ailudake_form_desert #精灵-埃鲁达克-形态-沙漠
22
+ pet_xiaoxiaokui #精灵-小小葵
23
+ pet_xiaoxiaokui_1 #精灵-笑笑葵 这俩精灵谐音就只能这样了
24
+ skill_fenlitupo #技能-奋力突破
25
+ mark_yinyueyinji #印记-银月印记
26
+ mark_status_burn #印记—不良状态-烧伤
27
+ ```
28
+
29
+ ### 效果
30
+
31
+ effect*关联印记/技能名\_timing*效果简述
32
+
33
+ ```example:plaintext
34
+ effect_burn_damage #烧伤-造成伤害
35
+ effect_fenlitupo_addyishang #奋力突破-添加易伤印记
36
+ ```
37
+
38
+ ## FAQ
39
+
40
+ ### 为啥用字符串?
41
+
42
+ 原版的数字id到后期十分混乱,甚至有一个数字id塞三四个技能的情况,唯一的优势就是在做excel的时候能看的干净一点,同一只精灵的一系列技能能放在一起。
43
+
44
+ 而使用字符串,配合命名约定能显著提升可读性、维护性和协作效率,同时也能简化代码的实现,因此不再遵循原版的规范。
45
+
46
+ ### 为啥用拼音?
47
+
48
+ 原作是纯中文字符串的。如果让我自己从头做的话当然会取个英文名的吧。我嫌每个重新取个名字太麻烦了。
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Arcadia Eternity contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/PACK_FORMAT.md ADDED
@@ -0,0 +1,93 @@
1
+ # Base Content Pack Format
2
+
3
+ ## Recommended Folder Layout
4
+
5
+ ```text
6
+ <pack-root>/
7
+ pack.json
8
+ assets/
9
+ *.png|*.jpg|*.webp|*.mp3|...
10
+ data/
11
+ mark*.yaml
12
+ skill*.yaml
13
+ groups/<group>/species.*.yaml
14
+ presentations/*.yaml
15
+ resources/*.yaml
16
+ dist/presentation.json # generated display manifest v2
17
+ src/effects/
18
+ *.ts
19
+ locales/
20
+ <locale>/
21
+ *.yaml
22
+ ```
23
+
24
+ For this repository's built-in pack package:
25
+
26
+ - `paths.dataDir = "data"`
27
+ - `paths.localesDir = "locales"`
28
+
29
+ ## `pack.json` Fields
30
+
31
+ - `id`: unique pack id
32
+ - `version`: pack version
33
+ - `engine`: must be `"seer2-v2"`
34
+ - `layoutVersion`: currently `1`
35
+ - `presentation`: generated display manifest path (`dist/presentation.json`)
36
+ - `paths.dataDir`: base dir for `data.*` file lists
37
+ - `paths.localesDir`: base dir for locale files
38
+ - `dependencies`: dependent pack list, loaded before current pack
39
+ - `data.marks|skills|species`: YAML filenames relative to `dataDir`
40
+ - `data.effects`: empty in the native base pack; retained for legacy manifest compatibility
41
+ - `locales`: locale -> namespace list (namespace maps to `<localesDir>/<locale>/<namespace>.yaml`)
42
+
43
+ ## Presentation and resources
44
+
45
+ Source definitions live in `data/presentations/` and `data/resources/`. Presentation records target content by kind and ID; slots reference stable resource IDs. Resource definitions own locations and media kinds. Gameplay records contain no paths or presentation fields.
46
+
47
+ The base build emits `dist/presentation.json` version 2. HTTP resources remain declarations. `loadMetadata` returns this separately from rules and locales; display consumers join it by content ID. Source movement does not change IDs. Changing a media location only updates its resource definition.
48
+
49
+ The previous `assets.json` mappings and duplicated resource YAML maps have been migrated. See [the presentation contract](../../docs/guides/content-presentation.md).
50
+
51
+ Dependency item format:
52
+
53
+ - `path`: relative path to dependent `pack.json`
54
+ - `id` (optional): expected dependent pack id (mismatch will fail)
55
+ - `optional` (optional): when true, missing/invalid dependency is skipped with warning
56
+
57
+ ## Loader APIs
58
+
59
+ Hosts construct `NativePackLoader` with the selected content package's build identity and trusted content factory.
60
+
61
+ - `load(packRef)`: load metadata, validate references against compiled effects, and return the executable content catalog
62
+ - `loadMetadata(packRef)`: read editable species, skill, and mark data for layer composition or resource inspection
63
+ - `fromMetadata(data)`: validate and assemble composed or unsaved metadata
64
+
65
+ File loading also returns locale bundles, presentation manifests, and lockfile diagnostics. Native effects are maintained in TypeScript; legacy effect YAML is kept only in regression fixtures.
66
+
67
+ ## npm Pack Resolution
68
+
69
+ `packRef` supports:
70
+
71
+ - file path: `./packs/base/pack.json`
72
+ - npm package: `npm:@scope/data-pack`
73
+ - npm package with explicit entry: `npm:@scope/data-pack#packs/base/pack.json`
74
+
75
+ When loading from npm package, loader reads package root `package.json` and uses:
76
+
77
+ - `arcadiaEternityPack` as manifest entry path, or
78
+ - default `pack.json` when field is missing.
79
+
80
+ ## Lockfile
81
+
82
+ Base pack can generate its own `pack-lock.yaml`:
83
+
84
+ ```bash
85
+ pnpm --filter @arcadia-eternity/data-pack-base run generate:lockfile
86
+ ```
87
+
88
+ Current generator behavior:
89
+
90
+ - emits pnpm-like `importers` and `packages`
91
+ - records the `pack.json` package node; presentation metadata is generated separately
92
+ - uses `workspace:` source refs when package metadata is available
93
+ - computes `sha512-*` integrity from local manifest content