圈地出租
拖框选 2~12 格,越界、压铺位、压物件都会被拦下;日租金预设 10 / 20 / 30 / 50,也可以填买断价一次卖断。
在你自己的站里圈一块地:玩家租铺上货,交子铺存钱生息,亥时一到,自动散集。
想暴富,先租铺
单文件插件 9,455 行 · SQLite / MySQL / PostgreSQL 通吃 · 零外部依赖
122项
素材白名单:118 张像素图 + 2 段音乐 + 2 份清单,合计约 8.9 MB
64格见方
默认模板 48×32 格;集市边长可在 8 到 200 格之间自定义
16个页签
村长后台从总览到审计日志一应俱全,另有 41 个前台接口
960×540
画布视口按整页等比缩放,像素不插值,地砖不糊边
瓦片拼接地图引擎
地面由 64px 瓦片无缝拼接,草地、泥地、小径、街道、青石板、青苔、农田土、胡桃木地板各成一式。 物件按底边中心格定位,y-sort 精确遮挡——树冠压住屋檐,货筐挡住人脚,谁在前谁在后,一目了然。
从进来到开张
第一次进集市只问一件事:性别。名字沿用论坛用户名,不另注册一套。 之后每一步都有明确去处——挑一块地、选一间样式、确认租赁,货就能上架。
村长把地图画到位,地皮满 64 格、物件至少 1 个,保存那一刻集市自动开张;没达标的日子,玩家只看到一扇贴了酒楼图样的门。
首次进入只选男士 / 女士两尊形象,头像与站点用户名直接同步,金币从 0 起步。
村长在空地上拖框选 2~12 格,写明摊位名称、用途标签与日租金(预设 10 / 20 / 30 / 50)。模板自带六块街面铺位:北街一二三号(杂货、茶食、布匹)、南街一二三号(书画、早点、酒肆)。
租下铺位后从 13 种样式里挑一间,货摆上货架;别人点开你的摊就能拍下,卡片以商品形式在帖子里流转。
货郎
游荡在南街 · 走南闯北第三年
「集市这几天可热闹了,听说东街又新开了铺子。」
「要我说啊,商品卡片这东西,买对了比金子还值。」
「掌柜的,慢慢逛,别踩着我家鹅。」
▼ 攀谈积分 ⇄ 金币 · 交子铺
两套货币打通,但口子攥在后台手里:基准汇率、买卖价差、每日波动、快捷兑换额度,全是一行行整数。 存钱生息、青苗借贷,则归交子铺的掌柜管。
基准 1 : 10
1 金币兑 10 积分起步,可调 0.01~100000;后台备了 1:1 / 1:10 / 1:50 / 1:100 四片预设。
买卖价差 4%
玩家买入价恒不低于卖出价的 104%,堵住来回套利的缝;每日还能开 ±5% 的行情波动。
快捷兑换 200 / 日
右上角的「兑换」按钮走小额通道,买卖合并计额度;想大额,去信用社找掌柜。
同事务提交
台账、积分、金币在一个事务里落库,固定锁序 + 32 位幂等键,重复请求只认一次。
铺位 · 货架 · 商品卡片
五级铺位逐级放开三件事:能挂多贵的货、能摆几件货、租金按什么系数算。 下面是后台「等级参数」的默认值,每一项都可另填。
| 铺位等级 | 售价上限(金币) | 货架位 | 租金系数 |
|---|---|---|---|
| Lv1 · 摊 | 200 | 4 位 | 1.0 |
| Lv2 · 铺 | 500 | 6 位 | 1.6 |
| Lv3 · 字号 | 1,200 | 8 位 | 2.4 |
| Lv4 · 大铺 | 3,000 | 10 位 | 3.5 |
| Lv5 · 总号 | 8,000 | 12 位 | 5.0 |
拖框选 2~12 格,越界、压铺位、压物件都会被拦下;日租金预设 10 / 20 / 30 / 50,也可以填买断价一次卖断。
到期先进 3 天宽限期,等级冻结;期满收回,样式、等级与全部卡片封存 30 天,期内重租同一铺位自动恢复。
标题 2~30 字、公开描述 300 字、徽章三档、每人限购可设;卡片正文 5000 字,购买者才看得到。
13 种铺面样式随插件发布,从布棚杂货摊到灯笼酒肆各有骨架;不想要的样式可在后台整类停用。
营收先进待结算钱包,次日零点到账;在线玩家零点后的第一次活动即时结清,另有每日任务兜底。
总览、商品、营收、买家、流水五页:今日营收、成本、净入、客人、正在逛、累计成交六个指标,配近 14 天曲线。
集市里的其他营生
道具分材料、完整道具与普通三类,品阶一到三星;两到五件材料能在铁匠铺熔成一件好东西, 多余的货可以挂进黑市寄卖。
道具上架即锁定,单笔 1~99 件、单价最高一亿金币;成交走行锁,手慢了提示「商品已被买走」。村长可整市歇业,在售商品原样保留。
每日一次,找村委会主事领今日福利:默认一册残破卷轴加两束干药材,最多配 12 条。领取瞬间道具图标会从建筑飞进右上角背包。
预置 18 项道具,一到三星决定图标底色,三星泛金光;单道具堆叠上限 999,背包格子过 99 显示「99+」。
素材清单
地砖无缝可平铺,人物是 4×4 的步态表,摊位按 3×2 格的骨架对齐碰撞盒。 插件里维护着一份素材白名单,站点放一张同名 PNG 就能把图换掉,不用改代码。
街坊与背景音
五类游荡的——货郎、摊主、挎篮妇人、顽童、老丈,各有各的步速;树下闲坐的、饮茶的老者、驻足张望的钉在原地。 编辑器里还能给每类圈定活动范围,出了框就不走。
两段音乐随包发布:白日一段主乐,散集一段黄昏调。 默认 22 时切到散集,清晨 6 点换回来——音量存在本机,开关在「更多」里。
村长体系
不用先学一套后台:管理员进站即村长,能开市、能圈地、能画地图。 村长专属的操作在服务端二次校验,普通玩家一律 403——这条是写进代码注释里的红线。
素材调色板分 9 个页签,地面连刷、装饰按住连刷、物件可拖可转;撤销 40 步,活动区域最多 60 个,保存的地图数据上限 8 MB。
总览、集市设置、签到福利、兑换、铺面、黑市、样式、商品、道具目录、熔炉配方、NPC 对话、财务流水、玩家、素材、审计、关于。
谁圈了哪块地、谁改了价、谁发放了金币都留痕,默认保留最近 800 条;金币流水按 20 种事由分类。
22 张表统一以 plugin_pixel_market_ 打头;函数、常量、CSS、JS 一律带 pixel_market_ 前缀,不跟别的插件抢名字。
散场也要扫干净
删掉集市文件夹、同步插件之后,数据表、计划任务、素材覆盖目录、备份文件, 还有发给用户的通知(含未读计数)其实都留在站里。 集市残留清理 v1.0.2 在后台给一个清扫入口,把这些明确属于集市的残留一次删净。
装一台集市
插件是一个文件夹,里头一份 plugin.php 加一目录素材。 下载、放进插件目录、同步插件,剩下的都在后台点。
从 GitHub Releases 取 jishi.zip,或到仓库页浏览源码。包内已含 122 项素材与两段音乐。
解压得到 pixel_market/,整目录放进站点的插件目录;想连散场清理一起装,就再放一个 pixel_market_cleaner/。
在站点后台同步一次,22 张 plugin_pixel_market_ 表自动建好,侧栏与搜索框右侧同时出现「集市」入口。
进后台「集市设置」载入模板或自定义地图——地皮满 64 格、物件至少 1 个,保存那一刻集市自动开张。
fdhrthrth / pixel_market
集市-online · 论坛内嵌的宋代市井风集市经营小游戏
想换素材:在后台「素材管理」打包上传,或在数据目录的覆盖层里放同名 PNG,白名单会告诉你哪一项没就位。
常见问题
装法、数据、性能、素材替换——站长最关心的四件事,先答在这儿。
不会。集市是内嵌在论坛里的一个插件页,入口有三处:侧栏「快捷功能」、搜索框右侧的「集市」按钮、管理员菜单里的「集市管理」。玩家身份直接沿用站点用户名,首次进入只补一个性别选项。
站点管理员默认即村长,不需要再在集市里申请一次权限。
兑换走固定通道:基准 1 金币 = 10 积分,玩家买入价至少比卖出价高 4%,快捷兑换每天 200 金币封顶(设为 0 就干脆隐藏按钮),信用社柜台才不受这个额度限制。行情还可以按 ±5% 每日波动。
交子铺的条款同样写在后台:定期存帖默认 7 天 0.5%、30 天 0.8%,最低存 100 金币、最多同时持有 3 张存帖,提前支取按 0.1% 活期算。青苗贷日息 1.5%,额度随在租铺位的等级水涨船高,逾期每日 3% 罚息、宽限 3 天。
边长 8 到 200 格,一格 64 设计像素;地图物件硬上限 2000,后台默认收到 800。
地面按 8×8 格区块做离屏缓存,改动才重绘;渲染只处理视口内的格子;碰撞是物件级的矩形与圆形盒,不是整图检测。寻路用八向 A* 并防切角,游荡 NPC 错峰计算路径,每帧只放一个。
能。插件里维护着一份 122 项的素材白名单(键 → 分类 / 文件 / 类型),站点在数据目录的同名覆盖层里放一张同名 PNG 就能替换,不用动代码;后台「素材管理」会列出每一项的就位状态与大小,也支持打包上传。
不想要的样式可以整类停用——比如默认停用的近代元素理发摊。
看得到当时那一版。购买瞬间会把标题、徽章与正文各存一份快照,与店主后续修改解耦;限购计数连软删记录一起算,防止反复上架绕额度。
未购买的路径上,查询语句里根本不取正文字段——这是注释里写明的防泄露红线。
SQLite、MySQL、PostgreSQL 三种驱动共用一套读写;22 张表全部以 plugin_pixel_market_ 打头,函数、常量、CSS、JS 也统一带 pixel_market_ 前缀。
兑换与购买这类涉及钱的操作在同一事务里提交,固定锁序,MySQL / PostgreSQL 用 FOR UPDATE,SQLite 靠 BEGIN IMMEDIATE。
删插件文件夹、同步插件之后,再装一次配套的 集市残留清理:它在后台列出遗留的数据表、计划任务、素材覆盖目录、备份文件和发给用户的通知,一键清扫,顺带修正未读计数。
清理插件只认明确属于集市的对象;它自己的表以 plugin_pixel_market_cleaner_ 打头,扫表时会跳过。