【进阶实战】货币运算规范：金币与点券的整数纪律

业务场景

寄售行一笔 0.1 金币手续费的单据让账目差了 1：货币字段里混进了小数，累计 3000 笔后对账差出 300 金币，财务对不上账。根因是货币运算没有纪律：有人用浮点算折扣、有人除法除出小数直接落库。货币运算规范封装：一切货币值整数化、除法向下取整、余数归属明确，三类纪律写进公共函数，全服货币路径统一走这一套。

核心实现

三类公共货币函数：加权扣费、比例分成、安全累加。示例代码如下：

lua

local function chargeFee(amount, feeRate)
    amount = math.floor(tonumber(amount) or 0)
    local fee = math.floor(amount * feeRate / 10000)
    return amount - fee, fee
end
local function splitLoot(total, n)
    total = math.floor(tonumber(total) or 0)
    n = math.max(math.floor(n) or 1, 1)
    local each = math.floor(total / n)
    local left = total - each * n
    return each, left
end
local function addGold(actorName, delta)
    local actor = getplayerbyname(actorName)
    delta = math.floor(tonumber(delta) or 0)
    local gold = math.floor(tonumber(getplayvar(actor, "HUMAN", "Gold")) or 0)
    local nv = math.max(gold + delta, 0)
    setplayvar(actor, "HUMAN", "Gold", nv, 1)
    return nv
end

手续费五菱分之一的费率走万分比整数：示例代码如下：

lua

local left, fee = chargeFee(300001, 500)

300001 金币按 5% 费率（万分之 500）收 15000 手续费，落库值与手续费都是整数，对账分毫不差。

接口拆解

chargeFee 的费率用万分比整数（500 即 5%），乘法后 math.floor 向下取整，手续费永远不超出应收。splitLoot 把不能整除的余数显式返回，余数给队长或入公会池，规则由调用方定但余数绝不悄悄消失。addGold 读改写全程 math.floor，任何上游传进来的小数在入口被压平，落库值恒为整数。

踩坑记录

货币运算踩过三个坑：一是折扣用 0.85 这类浮点系数连乘 30 次，5000 万金币的总额差出 2 金币，全链路改万分比整数乘加 floor 后归零；二是均分 301 金币给 4 人时各 75 元余 1 元，余数被四舍五入凭空蒸发，累计成对账缺口，余数必须显式入账；三是 Gold 变量被活动脚本写成 "50000" 字符串形态，下次 addGold 里 tonumber 兜住没报错但另一处直接算术的代码炸了——货币读写的公共函数是唯一入口，旁路访问一律在评审时拦下。

作者履历与出处

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。

📖 接口说明API × 3

math.floor 系统函数 math.floor(...)

...

返回：返回小于等于该数的最大整数

向下取整

tonumber 系统函数 tonumber(...)

...

返回：把字符串或值转为数字，失败返回 nil

转数值

math.max 系统函数 math.max(...)

...

返回：返回多个数中的最大值

取较大值

← 返回文章地图返回研学路径

业务场景

核心实现

接口拆解

踩坑记录

最新技术文章 · 实战干货

【策划架构】帮会试炼场：限时挑战的门票与积分设计

【策划架构】帮会会费：成员会费的收缴与公示设计

【策划架构】募兵编制：帮会扩军的募兵与编制作业设计

【高级技巧】协程超时兜底：resume与pcall的组合封装

【高级技巧】协程双向通信：resume传参与yield回传封装

【进阶实战】摆摊自动补货：摊位库存的定时补齐封装