<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="zh-Hans">
	<id>https://xenoblade.cn/index.php?action=history&amp;feed=atom&amp;title=%E6%A8%A1%E5%9D%97%3ATbox</id>
	<title>模块:Tbox - 版本历史</title>
	<link rel="self" type="application/atom+xml" href="https://xenoblade.cn/index.php?action=history&amp;feed=atom&amp;title=%E6%A8%A1%E5%9D%97%3ATbox"/>
	<link rel="alternate" type="text/html" href="https://xenoblade.cn/index.php?title=%E6%A8%A1%E5%9D%97:Tbox&amp;action=history"/>
	<updated>2026-11-19T07:14:51Z</updated>
	<subtitle>本wiki上该页面的版本历史</subtitle>
	<generator>MediaWiki 1.43.9</generator>
	<entry>
		<id>https://xenoblade.cn/index.php?title=%E6%A8%A1%E5%9D%97:Tbox&amp;diff=4063&amp;oldid=prev</id>
		<title>头号云：​创建页面，内容为“-- 模块:Tbox —— 宝箱渲染层（列表 / 单箱 infobox / SMW 注解） -- -- 用法： --   {{#invoke:Tbox|list}}                    全部 20 个宝箱（按地图分组） --   {{#invoke:Tbox|list|map=ma1202}}         指定地图 --   {{#invoke:Tbox|list|mapName=监狱岛}}      按地图中文名 --   {{#invoke:Tbox|infobox|id=7}}            单个宝箱信息框 --   {{#invoke:Tbox|whereItem|代达罗斯}}        反向查询：某物品出自哪…”</title>
		<link rel="alternate" type="text/html" href="https://xenoblade.cn/index.php?title=%E6%A8%A1%E5%9D%97:Tbox&amp;diff=4063&amp;oldid=prev"/>
		<updated>2026-10-14T16:11:10Z</updated>

		<summary type="html">&lt;p&gt;创建页面，内容为“-- 模块:Tbox —— 宝箱渲染层（列表 / 单箱 infobox / SMW 注解） -- -- 用法： --   {{#invoke:Tbox|list}}                    全部 20 个宝箱（按地图分组） --   {{#invoke:Tbox|list|map=ma1202}}         指定地图 --   {{#invoke:Tbox|list|mapName=监狱岛}}      按地图中文名 --   {{#invoke:Tbox|infobox|id=7}}            单个宝箱信息框 --   {{#invoke:Tbox|whereItem|代达罗斯}}        反向查询：某物品出自哪…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;-- 模块:Tbox —— 宝箱渲染层（列表 / 单箱 infobox / SMW 注解）&lt;br /&gt;
--&lt;br /&gt;
-- 用法：&lt;br /&gt;
--   {{#invoke:Tbox|list}}                    全部 20 个宝箱（按地图分组）&lt;br /&gt;
--   {{#invoke:Tbox|list|map=ma1202}}         指定地图&lt;br /&gt;
--   {{#invoke:Tbox|list|mapName=监狱岛}}      按地图中文名&lt;br /&gt;
--   {{#invoke:Tbox|infobox|id=7}}            单个宝箱信息框&lt;br /&gt;
--   {{#invoke:Tbox|whereItem|代达罗斯}}        反向查询：某物品出自哪些宝箱（SMW）&lt;br /&gt;
--&lt;br /&gt;
-- 数据来源：模块:TboxData（硬编码快照）。&lt;br /&gt;
--   待 XB1DEData 注册 FLD_tboxlist / Gimlist 后，把 TboxData 换成实时取数即可，&lt;br /&gt;
--   本模块对外接口完全不变。&lt;br /&gt;
--&lt;br /&gt;
-- 地图：本期不启用。XB1DEWikiMap 目前只认 mine/collection/enemy 三种图层&lt;br /&gt;
--   （渲染器选择器 `.xb1map-${mode}`），宝箱图层需站长加 REST 端点后才能挂载。&lt;br /&gt;
&lt;br /&gt;
local p = {}&lt;br /&gt;
&lt;br /&gt;
local data = require(&amp;quot;Module:TboxData&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
-- ====== SMW 属性（需先在 wiki 上建好属性页，见《上线流程》） ======&lt;br /&gt;
-- 属性:Tbox编号     Number  — FLD_tboxlist.__id&lt;br /&gt;
-- 属性:Tbox地图     Text    — 地图中文名&lt;br /&gt;
-- 属性:Tbox地标     Text    — 最近地标&lt;br /&gt;
-- 属性:Tbox物品     Text    — 箱内物品（顿号连接，仅展示）&lt;br /&gt;
-- 属性:Tbox物品名   Text    — 箱内物品（多值，供 #ask 反查）&lt;br /&gt;
-- 属性:Tbox物品数   Number  — 箱内物品件数&lt;br /&gt;
-- 属性:Tbox坐标X    Number&lt;br /&gt;
-- 属性:Tbox坐标Y    Number&lt;br /&gt;
-- 属性:Tbox坐标Z    Number&lt;br /&gt;
&lt;br /&gt;
local seen = {}  -- 同一次页面解析内防重复注解&lt;br /&gt;
&lt;br /&gt;
-- 物品名 → 站内页面。存在则加链接，不存在则纯文本（避免红链）。&lt;br /&gt;
-- 现状：50 个物品里 36 个已有「物品:」页；宝珠/战技教学书类尚无独立页。&lt;br /&gt;
local function itemLink(name)&lt;br /&gt;
  local t = mw.title.new(&amp;quot;物品:&amp;quot; .. name)&lt;br /&gt;
  if t and t.exists then&lt;br /&gt;
    return &amp;quot;[[&amp;quot; .. t.fullText .. &amp;quot;|&amp;quot; .. name .. &amp;quot;]]&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
  return name&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- ====== SMW 注解：每个宝箱一个 subobject ======&lt;br /&gt;
-- 依据《SMW踩坑记录》§13：多实体必须用 subobject，不能用 #set&lt;br /&gt;
--   （#set 会把整页箱子的值堆进同一属性，无法回答「哪一箱有这把武器」）&lt;br /&gt;
local function annotate(c)&lt;br /&gt;
  if seen[c.id] then return end&lt;br /&gt;
  seen[c.id] = true&lt;br /&gt;
&lt;br /&gt;
  local smw = mw.smw&lt;br /&gt;
  if smw == nil then return end  -- SMW 不可用时静默跳过，页面照常渲染&lt;br /&gt;
&lt;br /&gt;
  local items = c.items or {}&lt;br /&gt;
  local sub = {&lt;br /&gt;
    [&amp;quot;Tbox编号&amp;quot;] = c.id,&lt;br /&gt;
    [&amp;quot;Tbox地图&amp;quot;] = c.mapName or &amp;quot;&amp;quot;,&lt;br /&gt;
    [&amp;quot;Tbox地标&amp;quot;] = c.landmark or &amp;quot;&amp;quot;,&lt;br /&gt;
    [&amp;quot;Tbox坐标X&amp;quot;] = c.x,&lt;br /&gt;
    [&amp;quot;Tbox坐标Y&amp;quot;] = c.y,&lt;br /&gt;
    [&amp;quot;Tbox坐标Z&amp;quot;] = c.z,&lt;br /&gt;
    [&amp;quot;Tbox物品数&amp;quot;] = #items,&lt;br /&gt;
  }&lt;br /&gt;
&lt;br /&gt;
  if #items &amp;gt; 0 then&lt;br /&gt;
    local arr = {}&lt;br /&gt;
    for i, n in ipairs(items) do arr[i] = n end&lt;br /&gt;
    sub[&amp;quot;Tbox物品名&amp;quot;] = arr               -- 多值属性，供反查&lt;br /&gt;
    sub[&amp;quot;Tbox物品&amp;quot;] = table.concat(arr, &amp;quot;、&amp;quot;)&lt;br /&gt;
  end&lt;br /&gt;
&lt;br /&gt;
  smw.subobject(sub)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- ====== 物品单元格 ======&lt;br /&gt;
local function itemCell(c)&lt;br /&gt;
  local names = c.items or {}&lt;br /&gt;
  if #names == 0 then return &amp;quot;&amp;lt;i&amp;gt;（无记录）&amp;lt;/i&amp;gt;&amp;quot; end&lt;br /&gt;
  local out = {}&lt;br /&gt;
  for _, n in ipairs(names) do&lt;br /&gt;
    table.insert(out, itemLink(n))&lt;br /&gt;
  end&lt;br /&gt;
  return table.concat(out, &amp;quot;&amp;lt;br&amp;gt;&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- ====== 列表（按地图分组） ======&lt;br /&gt;
function p.list(frame)&lt;br /&gt;
  local args = frame.args&lt;br /&gt;
  local wantMap = args.map&lt;br /&gt;
  local wantName = args.mapName&lt;br /&gt;
&lt;br /&gt;
  local byMap = data.byMap()&lt;br /&gt;
  local out = {}&lt;br /&gt;
&lt;br /&gt;
  for _, mapId in ipairs(data.mapOrder) do&lt;br /&gt;
    local grp = byMap[mapId]&lt;br /&gt;
    if grp&lt;br /&gt;
      and (wantMap == nil or wantMap == mapId)&lt;br /&gt;
      and (wantName == nil or wantName == grp.name) then&lt;br /&gt;
&lt;br /&gt;
      table.insert(out, &amp;#039;&amp;lt;h3&amp;gt;&amp;#039; .. grp.name .. &amp;#039;&amp;lt;/h3&amp;gt;&amp;#039;)&lt;br /&gt;
      table.insert(out, &amp;#039;&amp;lt;table class=&amp;quot;wikitable xbtable&amp;quot; style=&amp;quot;text-align:left;&amp;quot;&amp;gt;&amp;#039;)&lt;br /&gt;
      table.insert(out, &amp;quot;&amp;lt;tr&amp;gt;&amp;lt;th&amp;gt;最近地标&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;内容&amp;lt;/th&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
      for _, c in ipairs(grp.list) do&lt;br /&gt;
        annotate(c)&lt;br /&gt;
        table.insert(out, &amp;quot;&amp;lt;tr&amp;gt;&amp;quot;)&lt;br /&gt;
        table.insert(out, &amp;quot;&amp;lt;td&amp;gt;&amp;quot; .. (c.landmark or &amp;quot;—&amp;quot;) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;quot;)&lt;br /&gt;
        table.insert(out, &amp;quot;&amp;lt;td&amp;gt;&amp;quot; .. itemCell(c) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;quot;)&lt;br /&gt;
        table.insert(out, &amp;quot;&amp;lt;/tr&amp;gt;&amp;quot;)&lt;br /&gt;
      end&lt;br /&gt;
&lt;br /&gt;
      table.insert(out, &amp;quot;&amp;lt;/table&amp;gt;&amp;quot;)&lt;br /&gt;
    end&lt;br /&gt;
  end&lt;br /&gt;
&lt;br /&gt;
  if #out == 0 then&lt;br /&gt;
    return &amp;quot;&amp;lt;i&amp;gt;未找到匹配的宝箱。&amp;lt;/i&amp;gt;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
  return table.concat(out, &amp;quot;\n&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- ====== 单个宝箱 infobox ======&lt;br /&gt;
function p.infobox(frame)&lt;br /&gt;
  local id = tonumber(frame.args.id or frame.args[1])&lt;br /&gt;
  local c = data.get(id)&lt;br /&gt;
  if not c then&lt;br /&gt;
    return &amp;quot;&amp;lt;i&amp;gt;未找到宝箱 #&amp;quot; .. tostring(id) .. &amp;quot;&amp;lt;/i&amp;gt;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
  annotate(c)&lt;br /&gt;
&lt;br /&gt;
  local out = {}&lt;br /&gt;
  table.insert(out, &amp;#039;&amp;lt;table class=&amp;quot;wikitable xbtable&amp;quot; style=&amp;quot;text-align:left;&amp;quot;&amp;gt;&amp;#039;)&lt;br /&gt;
  table.insert(out, &amp;#039;&amp;lt;tr&amp;gt;&amp;lt;th colspan=&amp;quot;2&amp;quot;&amp;gt;宝箱 #&amp;#039; .. c.id .. &amp;#039;（&amp;#039; .. c.mapName .. &amp;#039;）&amp;lt;/th&amp;gt;&amp;lt;/tr&amp;gt;&amp;#039;)&lt;br /&gt;
  table.insert(out, &amp;quot;&amp;lt;tr&amp;gt;&amp;lt;th&amp;gt;最近地标&amp;lt;/th&amp;gt;&amp;lt;td&amp;gt;&amp;quot; .. (c.landmark or &amp;quot;—&amp;quot;) ..&lt;br /&gt;
    (c.dist and (&amp;quot;（约 &amp;quot; .. string.format(&amp;quot;%.0f&amp;quot;, c.dist) .. &amp;quot;）&amp;quot;) or &amp;quot;&amp;quot;) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot;)&lt;br /&gt;
  table.insert(out, &amp;#039;&amp;lt;tr&amp;gt;&amp;lt;th&amp;gt;坐标&amp;lt;/th&amp;gt;&amp;lt;td&amp;gt;&amp;lt;code&amp;gt;&amp;#039; ..&lt;br /&gt;
    string.format(&amp;quot;%.1f, %.1f, %.1f&amp;quot;, c.x, c.y, c.z) .. &amp;quot;&amp;lt;/code&amp;gt;&amp;lt;/td&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot;)&lt;br /&gt;
  table.insert(out, &amp;quot;&amp;lt;tr&amp;gt;&amp;lt;th&amp;gt;内容&amp;lt;/th&amp;gt;&amp;lt;td&amp;gt;&amp;quot; .. itemCell(c) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot;)&lt;br /&gt;
  table.insert(out, &amp;#039;&amp;lt;tr&amp;gt;&amp;lt;th&amp;gt;gimID&amp;lt;/th&amp;gt;&amp;lt;td&amp;gt;&amp;#039; .. c.gimID .. &amp;quot;&amp;lt;/td&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot;)&lt;br /&gt;
  table.insert(out, &amp;quot;&amp;lt;/table&amp;gt;&amp;quot;)&lt;br /&gt;
  return table.concat(out, &amp;quot;\n&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- ====== 反向查询：某物品出自哪些宝箱 ======&lt;br /&gt;
-- 用法：{{#invoke:Tbox|whereItem|代达罗斯}} 或 |物品名=代达罗斯&lt;br /&gt;
function p.whereItem(frame)&lt;br /&gt;
  local name = frame.args[&amp;quot;物品名&amp;quot;] or frame.args[1]&lt;br /&gt;
  if not name or name == &amp;quot;&amp;quot; then&lt;br /&gt;
    return &amp;quot;&amp;lt;i&amp;gt;请指定物品名&amp;lt;/i&amp;gt;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
  local smw = mw.smw&lt;br /&gt;
  if smw == nil then return &amp;quot;&amp;lt;i&amp;gt;SMW 不可用&amp;lt;/i&amp;gt;&amp;quot; end&lt;br /&gt;
&lt;br /&gt;
  local res = smw.ask {&lt;br /&gt;
    &amp;quot;[[Tbox物品名::&amp;quot; .. name .. &amp;quot;]]&amp;quot;,&lt;br /&gt;
    &amp;quot;?Tbox地图&amp;quot;,&lt;br /&gt;
    &amp;quot;?Tbox地标&amp;quot;,&lt;br /&gt;
    &amp;quot;?Tbox编号&amp;quot;,&lt;br /&gt;
    mainlabel = &amp;quot;宝箱&amp;quot;,&lt;br /&gt;
  }&lt;br /&gt;
  if not res or #res == 0 then&lt;br /&gt;
    return &amp;quot;&amp;lt;i&amp;gt;没有宝箱记录包含「&amp;quot; .. name .. &amp;quot;」。&amp;lt;/i&amp;gt;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
&lt;br /&gt;
  local out = { &amp;#039;&amp;lt;table class=&amp;quot;wikitable xbtable&amp;quot;&amp;gt;&amp;#039;,&lt;br /&gt;
    &amp;quot;&amp;lt;tr&amp;gt;&amp;lt;th&amp;gt;宝箱&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;地图&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;最近地标&amp;lt;/th&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot; }&lt;br /&gt;
  for _, r in ipairs(res) do&lt;br /&gt;
    table.insert(out, &amp;quot;&amp;lt;tr&amp;gt;&amp;lt;td&amp;gt;&amp;quot; .. tostring(r[1] or &amp;quot;?&amp;quot;) ..&lt;br /&gt;
      &amp;quot;&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;&amp;quot; .. tostring(r[&amp;quot;Tbox地图&amp;quot;] or &amp;quot;?&amp;quot;) ..&lt;br /&gt;
      &amp;quot;&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;&amp;quot; .. tostring(r[&amp;quot;Tbox地标&amp;quot;] or &amp;quot;?&amp;quot;) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot;)&lt;br /&gt;
  end&lt;br /&gt;
  table.insert(out, &amp;quot;&amp;lt;/table&amp;gt;&amp;quot;)&lt;br /&gt;
  return table.concat(out, &amp;quot;\n&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
return p&lt;/div&gt;</summary>
		<author><name>头号云</name></author>
	</entry>
</feed>