📚 LUA脚本制作详细说明 - AzerothCore数据库文档

1. 什么是LUA脚本

LUA是一种轻量级的脚本语言，在魔兽世界私服开发中，我们使用Eluna引擎来运行LUA脚本。通过LUA脚本，您可以：

创建自定义的NPC对话和行为
制作特殊的物品效果
设计独特的任务机制
实现服务器事件和活动
添加新的游戏功能

💡 为什么选择LUA？

LUA语法简单易学，执行效率高，而且可以热重载（不需要重启服务器就能更新脚本），非常适合游戏开发。

2. 环境准备

重要提醒：在开始编写LUA脚本之前，我们需要准备好开发环境。就像做饭前要准备好厨具一样！

2.1 检查服务器是否支持LUA脚本

⚠️ 第一步：确认您的服务器支持Eluna

不是所有的魔兽世界私服都支持LUA脚本，您需要确认您的服务器已经安装了Eluna模块。

打开游戏，登录您的GM账号
- 在聊天框输入：.help eluna
- 如果显示相关命令，说明服务器支持Eluna
- 如果显示"未知命令"，说明服务器没有安装Eluna模块
查找服务器的lua_scripts文件夹
- 打开您的服务器文件夹（通常在D盘或C盘）
- 寻找名为"lua_scripts"的文件夹
- 如果没有这个文件夹，请手动创建一个
测试脚本加载功能
- 在游戏中输入：.reload eluna
- 如果没有报错，说明一切正常
- 如果有错误提示，请联系服务器管理员

2.2 安装文本编辑器（重要！）

为什么需要专业的文本编辑器？
Windows自带的记事本会导致编码问题，让您的中文字符在游戏中显示为乱码。我们需要一个支持UTF-8编码的编辑器。

推荐编辑器：Notepad++（简单易用）

下载Notepad++
- 打开浏览器，搜索"Notepad++ 官网"
- 下载最新版本（完全免费）
- 安装时选择中文界面
设置LUA语法高亮
- 打开Notepad++
- 点击菜单：语言 → L → Lua
- 现在代码会有颜色高亮显示
设置UTF-8编码
- 点击菜单：编码 → 转为UTF-8编码
- 这样保存的文件不会有乱码问题

2.3 创建脚本文件夹结构

为了方便管理，我们需要在lua_scripts文件夹中创建子文件夹：

打开服务器的lua_scripts文件夹
- 用文件管理器打开您的服务器目录
- 找到lua_scripts文件夹并双击打开
创建子文件夹
- 右键空白处 → 新建 → 文件夹
- 创建以下文件夹：

lua_scripts/ ← 这是主文件夹 ├── player/ ← 存放玩家相关脚本 ├── creature/ ← 存放NPC和怪物脚本 ├── item/ ← 存放物品脚本 ├── spell/ ← 存放法术脚本 ├── world/ ← 存放世界事件脚本 ├── custom/ ← 存放自定义脚本 └── test/ ← 存放测试脚本（新增）

💡 小贴士

如果您是完全的新手，建议先在test文件夹中练习，等熟练后再把脚本移到对应的分类文件夹中。

2.4 准备测试环境

创建测试账号
- 注册一个专门用于测试的游戏账号
- 给这个账号GM权限（方便测试）
- 创建一个测试角色
准备常用GM命令
- .reload eluna - 重新加载所有LUA脚本
- .tele stormwind - 传送到暴风城
- .levelup 80 - 升级到80级
- .additem 物品ID 数量 - 添加物品

⚠️ 重要提醒

在正式服务器上测试脚本可能会影响其他玩家，建议在测试服务器或单机环境下进行开发。

3. LUA基础语法

重要说明：如果您完全没有编程基础，不用担心！我们会从最基础的概念开始，一步一步教您。

3.1 什么是注释？

注释就是给人看的说明文字，电脑会忽略这些内容。在LUA中，注释用两个减号开头：

-- 这是一行注释，电脑不会执行这行
-- 您可以在这里写任何说明文字
-- 比如：这个脚本是用来欢迎玩家的
                

💡 为什么要写注释？

注释可以帮助您记住代码的作用，也方便其他人理解您的代码。养成写注释的好习惯非常重要！

3.2 变量和数据类型（超详细讲解）

什么是变量？
变量就像一个盒子，可以存放不同的东西。在编程中，我们用变量来存放数据。

3.2.1 字符串（文字）

字符串就是文字，必须用引号包起来：

-- 创建一个存放玩家名字的变量
local playerName = "张三"

-- 创建一个存放欢迎消息的变量
local welcomeMessage = "欢迎来到我们的服务器！"

-- 注意：字符串必须用引号包起来，可以用双引号"或单引号'
local serverName = '我的魔兽服务器'
                

3.2.2 数字

数字不需要引号，直接写就可以：

-- 玩家等级
local playerLevel = 80

-- 玩家金币数量
local playerGold = 10000

-- 小数也可以
local playerHealth = 95.5
                

3.2.3 布尔值（真假）

布尔值只有两个：true（真）和false（假）

-- 玩家是否在线
local isOnline = true

-- 玩家是否死亡
local isDead = false

-- 服务器是否开启PVP
local pvpEnabled = true
                

3.2.4 表（容器）

表就像一个大盒子，可以存放多个东西：

-- 创建一个空的表
local playerData = {}

-- 创建一个存放多个玩家名字的表
local playerNames = {"张三", "李四", "王五"}

-- 创建一个存放玩家信息的表
local player = {
    name = "张三",
    level = 80,
    gold = 10000,
    isOnline = true
}
                

3.3 字符串连接（把文字拼在一起）

在LUA中，用两个点(..)来连接字符串：

-- 把两个字符串连接起来
local firstName = "张"
local lastName = "三"
local fullName = firstName .. lastName  -- 结果是"张三"

-- 连接字符串和数字
local playerName = "张三"
local playerLevel = 80
local message = playerName .. "的等级是" .. playerLevel
-- 结果是"张三的等级是80"
                

什么是变量？
变量就像一个盒子，可以存放不同的东西。在编程中，我们用变量来存放数据。

3.2.1 字符串（文字）

字符串就是文字，必须用引号包起来：

-- 创建一个存放玩家名字的变量
local playerName = "张三"

-- 创建一个存放欢迎消息的变量
local welcomeMessage = "欢迎来到我们的服务器！"

-- 注意：字符串必须用引号包起来，可以用双引号"或单引号'
local serverName = '我的魔兽服务器'
                

3.2.2 数字

数字不需要引号，直接写就可以：

-- 玩家等级
local playerLevel = 80

-- 玩家金币数量
local playerGold = 10000

-- 小数也可以
local playerHealth = 95.5
                

3.2.3 布尔值（真假）

布尔值只有两个：true（真）和false（假）

-- 玩家是否在线
local isOnline = true

-- 玩家是否死亡
local isDead = false

-- 服务器是否开启PVP
local pvpEnabled = true
                

3.2.4 表（容器）

表就像一个大盒子，可以存放多个东西：

-- 创建一个空的表
local playerData = {}

-- 创建一个存放多个玩家名字的表
local playerNames = {"张三", "李四", "王五"}

-- 创建一个存放玩家信息的表
local player = {
    name = "张三",
    level = 80,
    gold = 10000,
    isOnline = true
}
                

3.3 字符串连接（把文字拼在一起）

在LUA中，用两个点(..)来连接字符串：

-- 把两个字符串连接起来
local firstName = "张"
local lastName = "三"
local fullName = firstName .. lastName  -- 结果是"张三"

-- 连接字符串和数字
local playerName = "张三"
local playerLevel = 80
local message = playerName .. "的等级是" .. playerLevel
-- 结果是"张三的等级是80"
                

3.4 条件语句（如果...那么...）

什么是条件语句？
就像生活中的"如果天下雨，那么我就带伞"一样，程序也可以根据条件做不同的事情。

3.4.1 基本的if语句

-- 如果玩家等级大于等于80，就发送满级消息
local playerLevel = 80

if playerLevel >= 80 then
    print("恭喜您达到满级！")
end
                

3.4.2 if...else语句（要么...要么...）

-- 如果玩家等级大于等于80，发送满级消息，否则发送升级消息
local playerLevel = 60

if playerLevel >= 80 then
    print("恭喜您达到满级！")
else
    print("继续努力升级吧！")
end
                

3.4.3 多重条件（多种情况）

-- 根据不同等级发送不同消息
local playerLevel = 60

if playerLevel >= 80 then
    print("您已经是满级大佬了！")
elseif playerLevel >= 60 then
    print("您已经很强了，继续加油！")
elseif playerLevel >= 30 then
    print("您正在快速成长！")
else
    print("新手村毕业加油！")
end
                

3.5 循环语句（重复做事情）

什么是循环？
就是让程序重复做同一件事情，比如给10个玩家都发送同样的消息。

3.5.1 for循环（数数循环）

-- 从1数到10，每次都打印一条消息
for i = 1, 10 do
    print("这是第" .. i .. "次循环")
end

-- 结果会打印：
-- 这是第1次循环
-- 这是第2次循环
-- ...一直到第10次
                

3.5.2 while循环（条件循环）

-- 当条件为真时，就一直重复
local count = 1

while count <= 5 do
    print("计数：" .. count)
    count = count + 1  -- 每次循环都让count加1
end

-- 结果会打印：计数：1, 计数：2, 计数：3, 计数：4, 计数：5
                

3.6 函数（把代码打包）

什么是函数？
函数就像一个工具箱，把一些常用的代码打包起来，需要时就调用它。

3.6.1 创建简单函数

-- 创建一个打招呼的函数
function SayHello()
    print("大家好！")
end

-- 调用函数（使用函数）
SayHello()  -- 会打印"大家好！"
                

3.6.2 带参数的函数

-- 创建一个可以向指定玩家打招呼的函数
function GreetPlayer(playerName)
    print("你好，" .. playerName .. "！")
end

-- 调用函数，传入玩家名字
GreetPlayer("张三")  -- 会打印"你好，张三！"
GreetPlayer("李四")  -- 会打印"你好，李四！"
                

3.6.3 有返回值的函数

-- 创建一个计算玩家奖励金币的函数
function CalculateReward(playerLevel)
    local reward = playerLevel * 100  -- 每级奖励100金币
    return reward  -- 返回计算结果
end

-- 使用函数并获取返回值
local playerLevel = 80
local goldReward = CalculateReward(playerLevel)
print("您获得了" .. goldReward .. "金币")  -- 会打印"您获得了8000金币"
                

💡 练习建议

建议您把这些代码复制到Notepad++中，仔细阅读每一行的注释，理解每个概念。不要急于求成，慢慢消化这些基础知识。

4. Eluna引擎基础

Eluna是专为魔兽世界模拟器设计的LUA脚本引擎。它提供了丰富的API来与游戏世界交互。

4.1 事件注册

Eluna使用事件驱动的方式工作。您需要注册事件监听器来响应游戏中的各种事件：

-- 注册玩家登录事件
local function OnPlayerLogin(event, player)
    player:SendBroadcastMessage("欢迎来到我们的服务器!")
end

-- 将函数绑定到事件
RegisterPlayerEvent(3, OnPlayerLogin) -- 3 = PLAYER_EVENT_ON_LOGIN
                

4.2 常用事件类型

玩家事件：登录、登出、升级、死亡等
生物事件：生成、死亡、战斗、对话等
物品事件：使用、装备、获得等
法术事件：施放、命中、效果等
服务器事件：启动、关闭、定时器等

💡 事件ID参考

每个事件都有对应的ID号，您可以在Eluna官方文档中查找具体的事件ID和参数说明。

5. 编写第一个脚本

激动人心的时刻到了！现在我们要编写您的第一个LUA脚本。不要紧张，我会一步一步详细指导您。

5.1 创建脚本文件（详细步骤）

⚠️ 开始前的重要提醒

请确保您已经安装了Notepad++或其他支持UTF-8编码的文本编辑器，并且找到了服务器的lua_scripts文件夹。

打开lua_scripts文件夹
- 用文件管理器打开您的服务器目录
- 找到并双击打开"lua_scripts"文件夹
- 如果没有这个文件夹，请先创建一个
创建新的脚本文件
- 在lua_scripts文件夹中右键点击空白处
- 选择"新建" → "文本文档"
- 将文件名改为"welcome.lua"（注意扩展名必须是.lua）
- 如果看不到扩展名，请在文件夹选项中显示文件扩展名
用正确的编辑器打开文件
- 右键点击"welcome.lua"文件
- 选择"打开方式" → "Notepad++"
- 如果没有Notepad++，请不要用Windows记事本！
设置正确的编码
- 在Notepad++中，点击菜单"编码"
- 选择"转为UTF-8编码"
- 这一步很重要，避免中文乱码

5.2 编写您的第一个脚本代码

现在，请在编辑器中输入以下代码。建议您手动输入而不是复制粘贴，这样可以更好地理解每一行代码：

-- welcome.lua - 玩家欢迎脚本
-- 作者：您的名字（请改成您自己的名字）
-- 创建日期：2023年12月
-- 功能：当玩家登录时发送欢迎消息

-- 第一步：定义一个处理玩家登录的函数
local function OnPlayerLogin(event, player)
    -- 获取玩家的名字
    local playerName = player:GetName()

    -- 获取玩家的等级
    local playerLevel = player:GetLevel()

    -- 向玩家发送欢迎消息（玩家会在聊天框看到）
    player:SendBroadcastMessage("=== 欢迎来到我们的服务器 ===")
    player:SendBroadcastMessage("欢迎回来, " .. playerName .. "!")
    player:SendBroadcastMessage("您当前的等级是: " .. playerLevel)
    player:SendBroadcastMessage("祝您游戏愉快!")

    -- 在服务器控制台输出日志（管理员可以看到）
    print("[欢迎脚本] 玩家 " .. playerName .. " (等级" .. playerLevel .. ") 已登录服务器")
end

-- 第二步：注册事件监听器
-- 这行代码告诉服务器：当玩家登录时，请调用OnPlayerLogin函数
RegisterPlayerEvent(3, OnPlayerLogin) -- 3 = PLAYER_EVENT_ON_LOGIN

-- 第三步：输出脚本加载成功的消息
print("[系统] 欢迎脚本已成功加载！")
                

💡 代码解释

每一行代码的作用：

local function OnPlayerLogin(event, player) - 创建一个处理登录的函数
player:GetName() - 获取玩家的名字
player:SendBroadcastMessage() - 向玩家发送消息
RegisterPlayerEvent(3, OnPlayerLogin) - 注册玩家登录事件
print() - 在服务器控制台输出信息

5.3 保存文件

检查代码
- 确保您输入的代码和上面的完全一样
- 特别注意引号、括号、分号是否正确
- 检查是否有拼写错误
保存文件
- 按Ctrl+S或点击"文件" → "保存"
- 确认文件名是"welcome.lua"
- 确认文件保存在lua_scripts文件夹中
检查编码
- 在Notepad++中查看右下角的编码显示
- 应该显示"UTF-8"
- 如果不是，请点击"编码" → "转为UTF-8编码"

5.4 测试脚本（详细步骤）

现在是最激动人心的时刻 - 测试您的第一个脚本是否工作！

重新加载脚本
- 启动您的魔兽世界服务器
- 登录游戏，确保您有GM权限
- 在聊天框输入：.reload eluna
- 如果成功，您应该在服务器控制台看到"欢迎脚本已成功加载！"
测试登录事件
- 退出游戏（完全关闭游戏客户端）
- 重新启动游戏并登录
- 观察聊天框是否出现欢迎消息
检查结果
- 如果看到欢迎消息，恭喜您成功了！
- 如果没有看到消息，请检查下面的故障排除部分

5.5 故障排除

⚠️ 如果脚本没有工作，请检查以下几点：

文件名错误：确保文件名是"welcome.lua"，不是"welcome.lua.txt"
文件位置错误：确保文件在正确的lua_scripts文件夹中
语法错误：检查代码是否完全正确，特别是引号和括号
编码问题：确保文件保存为UTF-8编码
服务器问题：确保服务器支持Eluna模块
权限问题：确保您的账号有GM权限

💡 成功的标志

如果一切正常，您应该看到：

聊天框显示欢迎消息
服务器控制台显示玩家登录日志
消息中包含您的角色名和等级

6. 事件系统详解

事件系统是Eluna的核心，理解事件系统对于编写高质量的脚本至关重要。

6.1 事件注册语法

-- 基本语法：RegisterXXXEvent(eventId, function)
RegisterPlayerEvent(eventId, functionName)    -- 玩家事件
RegisterCreatureEvent(entryId, eventId, functionName) -- 生物事件
RegisterItemEvent(itemId, eventId, functionName)      -- 物品事件
RegisterServerEvent(eventId, functionName)    -- 服务器事件
                

6.2 常用玩家事件

-- 玩家登录 (事件ID: 3)
RegisterPlayerEvent(3, OnPlayerLogin)

-- 玩家登出 (事件ID: 4)
RegisterPlayerEvent(4, OnPlayerLogout)

-- 玩家升级 (事件ID: 13)
RegisterPlayerEvent(13, OnPlayerLevelUp)

-- 玩家死亡 (事件ID: 6)
RegisterPlayerEvent(6, OnPlayerDeath)

-- 玩家击杀生物 (事件ID: 7)
RegisterPlayerEvent(7, OnPlayerKillCreature)
                

6.3 事件函数参数

不同的事件会传递不同的参数给处理函数：

-- 玩家登录事件：(event, player)
local function OnPlayerLogin(event, player)
    -- event: 事件ID
    -- player: 玩家对象
end

-- 玩家击杀生物事件：(event, player, creature)
local function OnPlayerKillCreature(event, player, creature)
    -- event: 事件ID
    -- player: 玩家对象
    -- creature: 被击杀的生物对象
end
                

7. 调试和测试

调试是脚本开发中非常重要的环节，掌握调试技巧可以大大提高开发效率。

7.1 使用print()函数调试

-- 在关键位置添加调试信息
local function OnPlayerLogin(event, player)
    print("调试：玩家登录事件触发")

    local playerName = player:GetName()
    print("调试：玩家名称 = " .. playerName)

    local playerLevel = player:GetLevel()
    print("调试：玩家等级 = " .. playerLevel)

    player:SendBroadcastMessage("欢迎, " .. playerName)
    print("调试：欢迎消息已发送")
end
                

7.2 错误处理

-- 使用pcall进行错误捕获
local function SafeFunction(player)
    local success, result = pcall(function()
        -- 可能出错的代码
        local playerName = player:GetName()
        player:SendBroadcastMessage("Hello " .. playerName)
        return true
    end)

    if not success then
        print("错误：脚本执行失败 - " .. result)
        return false
    end

    return result
end
                

7.3 常见错误和解决方法

语法错误：检查括号、引号是否匹配，关键字是否正确
nil值错误：在使用对象前检查是否为nil
事件ID错误：确认使用正确的事件ID
编码问题：确保文件保存为UTF-8编码

💡 调试技巧

在开发阶段，建议在脚本中添加详细的调试信息。发布时可以通过全局变量控制是否显示调试信息。

8. 进阶技巧

掌握这些进阶技巧可以让您编写更高效、更强大的脚本。

8.1 定时器使用

-- 创建定时器
local function DelayedMessage(player)
    player:SendBroadcastMessage("5秒后的消息!")
end

-- 在玩家登录5秒后发送消息
local function OnPlayerLogin(event, player)
    player:SendBroadcastMessage("欢迎登录!")

    -- 创建5秒延迟的定时器
    CreateLuaEvent(DelayedMessage, 5000, 1, player)
end
                

8.2 数据库操作

-- 查询数据库
local function GetPlayerData(player)
    local playerGUID = player:GetGUIDLow()
    local query = "SELECT level, money FROM characters WHERE guid = " .. playerGUID

    local result = CharDBQuery(query)
    if result then
        local level = result:GetUInt32(0)
        local money = result:GetUInt32(1)
        print("玩家等级：" .. level .. ", 金币：" .. money)
    end
end

-- 更新数据库
local function UpdatePlayerMoney(player, amount)
    local playerGUID = player:GetGUIDLow()
    local query = "UPDATE characters SET money = money + " .. amount ..
                " WHERE guid = " .. playerGUID
    CharDBExecute(query)
end
                

8.3 配置文件使用

-- 在脚本开头定义配置
local CONFIG = {
    WELCOME_MESSAGE = "欢迎来到我们的服务器!",
    BONUS_GOLD = 1000,
    MAX_LEVEL = 80,
    DEBUG_MODE = true
}

-- 使用配置
local function OnPlayerLogin(event, player)
    player:SendBroadcastMessage(CONFIG.WELCOME_MESSAGE)

    if player:GetLevel() >= CONFIG.MAX_LEVEL then
        player:ModifyMoney(CONFIG.BONUS_GOLD)
    end

    if CONFIG.DEBUG_MODE then
        print("调试：玩家 " .. player:GetName() .. " 已登录")
    end
end
                

9. 实用示例

以下是一些实用的脚本示例，您可以直接使用或作为参考。

9.1 自动复活脚本

-- 玩家死亡时自动复活
local function OnPlayerDeath(event, player, killer)
    -- 等待3秒后复活
    CreateLuaEvent(function()
        if player:IsDead() then
            player:ResurrectPlayer(1.0) -- 满血复活
            player:SpawnForPlayer(player) -- 刷新玩家状态
            player:SendBroadcastMessage("您已自动复活!")
        end
    end, 3000, 1)
end

RegisterPlayerEvent(6, OnPlayerDeath) -- PLAYER_EVENT_ON_DEATH
                

9.2 升级奖励脚本

-- 玩家升级时给予奖励
local function OnPlayerLevelUp(event, player, oldLevel)
    local newLevel = player:GetLevel()
    local goldReward = newLevel * 100 -- 每级奖励100金币

    -- 给予金币奖励
    player:ModifyMoney(goldReward)

    -- 发送祝贺消息
    player:SendBroadcastMessage("恭喜升级到 " .. newLevel .. " 级!")
    player:SendBroadcastMessage("获得奖励金币: " .. goldReward)

    -- 特殊等级奖励
    if newLevel == 10 then
        player:AddItem(6948, 1) -- 炉石
        player:SendBroadcastMessage("获得特殊奖励：炉石!")
    elseif newLevel == 60 then
        player:AddItem(19019, 1) -- 雷霆之怒
        player:SendBroadcastMessage("获得传说武器：雷霆之怒!")
    end
end

RegisterPlayerEvent(13, OnPlayerLevelUp) -- PLAYER_EVENT_ON_LEVEL_CHANGE
                

9.3 自定义传送NPC

-- 传送NPC对话处理
local TELEPORT_NPC_ID = 190000 -- 自定义NPC ID

local function OnGossipHello(event, player, creature)
    player:GossipClearMenu()
    player:GossipMenuAddItem(0, "传送到暴风城", 1, 1)
    player:GossipMenuAddItem(0, "传送到奥格瑞玛", 1, 2)
    player:GossipMenuAddItem(0, "传送到达拉然", 1, 3)
    player:GossipSendMenu(1, creature)
end

local function OnGossipSelect(event, player, creature, sender, action)
    if action == 1 then
        player:Teleport(0, -8833.38, 628.62, 94.00, 1.06) -- 暴风城
    elseif action == 2 then
        player:Teleport(1, 1676.21, -4315.29, 61.52, 1.54) -- 奥格瑞玛
    elseif action == 3 then
        player:Teleport(571, 5804.15, 624.77, 647.77, 1.64) -- 达拉然
    end
    player:GossipComplete()
end

RegisterCreatureGossipEvent(TELEPORT_NPC_ID, 1, OnGossipHello)
RegisterCreatureGossipEvent(TELEPORT_NPC_ID, 2, OnGossipSelect)
                

10. 常见问题解决

在LUA脚本开发过程中，新手经常遇到一些常见问题。以下是解决方案：

10.1 脚本不生效

⚠️ 问题：脚本文件已放入lua_scripts文件夹，但没有效果

解决方案：

检查服务器是否启用了Eluna模块
确认脚本文件扩展名为.lua
使用.reload eluna命令重新加载脚本
检查服务器控制台是否有错误信息
确认脚本语法正确，没有语法错误

10.2 中文字符显示乱码

⚠️ 问题：脚本中的中文字符在游戏中显示为乱码

解决方案：

确保脚本文件保存为UTF-8编码
在Notepad++中：编码 → 转为UTF-8编码
在VS Code中：右下角点击编码，选择UTF-8
避免使用Windows记事本编辑脚本

10.3 事件不触发

⚠️ 问题：注册了事件但事件处理函数没有被调用

解决方案：

检查事件ID是否正确
确认函数名拼写正确
对于生物事件，检查生物ID是否正确
对于物品事件，检查物品ID是否正确
在函数开头添加print()调试信息

10.4 性能优化建议

💡 优化技巧

避免在高频事件中进行复杂计算
使用local变量而不是全局变量
合理使用定时器，避免创建过多定时器
数据库查询要谨慎，避免频繁查询
及时清理不需要的事件监听器

10.5 学习资源推荐

Eluna官方文档：https://elunaluaengine.github.io/
LUA官方教程：https://www.lua.org/manual/5.3/
AzerothCore文档：https://www.azerothcore.org/
社区论坛：加入相关QQ群或Discord频道交流学习

10.6 开发流程建议

先在测试服务器上开发和测试脚本
编写详细的注释，方便后期维护
使用版本控制工具（如Git）管理脚本代码
定期备份重要的脚本文件
在正式服务器部署前进行充分测试

💡 最后的建议

LUA脚本开发需要耐心和实践。建议从简单的脚本开始，逐步学习更复杂的功能。遇到问题时，多查阅文档，多与社区交流，相信您很快就能成为LUA脚本开发高手！

📋 教程目录

1. 什么是LUA脚本

💡 为什么选择LUA？

2. 环境准备

2.1 检查服务器是否支持LUA脚本

⚠️ 第一步：确认您的服务器支持Eluna

2.2 安装文本编辑器（重要！）

推荐编辑器：Notepad++（简单易用）

2.3 创建脚本文件夹结构

💡 小贴士

2.4 准备测试环境

⚠️ 重要提醒

3. LUA基础语法

3.1 什么是注释？

💡 为什么要写注释？

3.2 变量和数据类型（超详细讲解）

3.2.1 字符串（文字）

3.2.2 数字

3.2.3 布尔值（真假）

3.2.4 表（容器）

3.3 字符串连接（把文字拼在一起）

3.2.1 字符串（文字）

3.2.2 数字

3.2.3 布尔值（真假）

3.2.4 表（容器）

3.3 字符串连接（把文字拼在一起）

3.4 条件语句（如果...那么...）

3.4.1 基本的if语句

3.4.2 if...else语句（要么...要么...）

3.4.3 多重条件（多种情况）

3.5 循环语句（重复做事情）

3.5.1 for循环（数数循环）

3.5.2 while循环（条件循环）

3.6 函数（把代码打包）

3.6.1 创建简单函数

3.6.2 带参数的函数

3.6.3 有返回值的函数

💡 练习建议

4. Eluna引擎基础

4.1 事件注册

4.2 常用事件类型

💡 事件ID参考

5. 编写第一个脚本

5.1 创建脚本文件（详细步骤）

⚠️ 开始前的重要提醒

5.2 编写您的第一个脚本代码

💡 代码解释

5.3 保存文件

5.4 测试脚本（详细步骤）

5.5 故障排除

⚠️ 如果脚本没有工作，请检查以下几点：

💡 成功的标志

6. 事件系统详解

6.1 事件注册语法

6.2 常用玩家事件

6.3 事件函数参数

7. 调试和测试

7.1 使用print()函数调试

7.2 错误处理

7.3 常见错误和解决方法

💡 调试技巧

8. 进阶技巧

8.1 定时器使用

8.2 数据库操作

8.3 配置文件使用

9. 实用示例

9.1 自动复活脚本

9.2 升级奖励脚本

9.3 自定义传送NPC

10. 常见问题解决

10.1 脚本不生效

⚠️ 问题：脚本文件已放入lua_scripts文件夹，但没有效果

10.2 中文字符显示乱码

⚠️ 问题：脚本中的中文字符在游戏中显示为乱码

10.3 事件不触发

⚠️ 问题：注册了事件但事件处理函数没有被调用

10.4 性能优化建议

💡 优化技巧

10.5 学习资源推荐

10.6 开发流程建议