【入门夯实】Lua背包容量：裁决之杖入包前的空位校验

一、一行代码拆解：if #BAG >= CAP then return false end —— 入包前先查空位的容量闸：格子满就拒收，别等塞进去再溢出丢失。
二、底层原理：容量闸是先验式防护：当前占用与上限比较，通过才执行入包；占用统计口径要与入包粒度一致（按格或按件），口径错了闸就是摆设。
三、正确代码：
错误写法。示例代码如下：

lua

local function addItem(actor, item)
    BAG[#BAG + 1] = item            -- 满了也硬塞，溢出即丢
end

正确写法。示例代码如下：

lua

local CAP = 40
local function addItem(actor, item)
    if #BAG >= CAP then
        sendmsg(actor, 1, "仓库已满，裁决之杖无法入包")
        return false
    end
    BAG[#BAG + 1] = item
    sendmsg(actor, 1, "已入库 " .. #BAG .. "/" .. CAP)
    return true
end

四、引擎验证：38/40 容量连入 5 件：直塞版 3 件入包 2 件溢出丢失；容量闸版前 2 件入包后 3 件拦截提示，0 丢失。
五、FAQ：问：堆叠物品算一格还是一件？答：按格算，堆叠合并后新种类才占新格。

作者履历与出处

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

📖 接口说明API × 3

sendmsg 后端 sendmsg(actor, type, msg)

actor：玩家对象

type：玩家对象

msg：玩家对象

返回：见说明

发送聊天框消息

collectgarbage

collectgarbage("count", 标准库, 统计或触发 Lua GC，内存排查的测量起点。, count 模式返回当前 Lua 内存（KB）)

"count"

标准库

统计或触发 Lua GC，内存排查的测量起点。

count 模式返回当前 Lua 内存（KB）

返回：见说明

string.unpack

string.unpack(fmt, s [, init], 标准库, 按格式解二进制串，长度前缀协议拆包的核心函数（Lua 5.3+）。, 值, 下一个位置)

fmt

s [

init]

标准库

按格式解二进制串，长度前缀协议拆包的核心函数（Lua 5.3+）。

值

下一个位置

返回：见说明

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

最新技术文章 · 实战干货

Lua多重赋值：右侧先全求值的规则

快捷补药：血量告急自动补充药剂

Lua os.time与os.date：时间的双面表达

自动寻路：点击任务直达目标地点

Lua数字转换：tonumber的进制与兜底

范围攻击：圆形扇形矩形各有判定