简介:AMXX 1.8.1 中文/繁體中文/英文版是一套面向 Half-Life 游戏服务器开发者与服主的多语言插件开发环境,基于 MetaMod 构建,用于创建自定义游戏模式、调整玩家能力、控制游戏流程及扩展新玩法。它同时提供简体中文、繁体中文与英文界面,降低了国内及台湾地区开发者的语言门槛,适合具备一定脚本基础、希望深入定制服务器的中高级用户。压缩包共 203 个文件,约 3.4MB,以 inc 头文件、sma 源码、amxx 编译插件、txt 文档、dll 动态库及 ini 配置为主,另含少量 exe 工具与 cfg 配置,覆盖开发、编译、部署与运行全流程。资源内附核心文件、开发工具、API 文档、示例插件与安装指南,并集成 statsx、admincmd、plmenu、miscstats 等常用插件,便于直接参考与二次开发。目前已有 530 人学习,可帮助读者快速搭建稳定的服务器插件体系,提升开发效率与游戏可玩性。
1. AMXX 1.8.1 多语言版:从零搭起一套能跑插件的服务端环境
如果你正在折腾一个基于 GoldSrc 引擎的服务端,多半绕不开 AMXX 1.8.1 这个版本。它不算新,但胜在稳定、插件生态成熟,中文、繁體中文、英文三套语言包齐全,很多老服务器至今还跑在这个版本上。问题在于,这套东西的安装过程对新手并不友好:装错了语言包,菜单全是乱码;模块没开对,插件加载直接失败;路径里带个空格,Metamod 就找不到 AMXX。我见过太多人卡在“插件放进去没反应”这一步,最后发现是modules.ini里少开了一行。这篇笔记按我自己的部署习惯,从环境确认、文件放置、核心配置到验证排错,一步步走完,目标是让你装完之后能直接进游戏看到插件生效,而不是对着日志猜哪里出了问题。
2. 装之前先把环境理清:版本、目录与依赖对照
2.1 确认服务端类型与 AMXX 1.8.1 的匹配关系
AMXX 1.8.1 是面向 GoldSrc 引擎服务端的插件运行平台,常见搭配是 Counter-Strike 1.6、Half-Life 死亡竞赛等。它本身不区分“中文版”或“英文版”的二进制核心,所谓多语言,指的是amxmodx/data/lang目录下那套语言文件,以及安装时选择的默认语言。核心文件amxmodx_mm.dll(Windows)或amxmodx_mm_i386.so(Linux)是统一的,语言只影响菜单、提示信息的显示。
我一般会先确认三件事:服务端是 Windows 还是 Linux、Metamod 是否已经装好、服务端根目录有没有中文或空格。前两个决定你拿哪个压缩包、放哪个目录,第三个是后面很多玄学问题的根源。AMXX 1.8.1 官方包通常包含addons/amxmodx和addons/metamod两部分,如果你之前已经装过 Metamod,可以只取 AMXX 部分,但版本要对得上。
提示:Metamod 版本建议用 1.21 或 1.21p37,这是和 AMXX 1.8.1 搭配最稳的组合,太新的 Metamod 反而可能在旧服务端上加载失败。
2.2 目录结构规划:把 addons 放在哪一层
GoldSrc 服务端的标准结构是hlds.exe或hlds_run所在目录为根,下面有cstrike(或valve)子目录,再下面是addons。AMXX 必须放在cstrike/addons/amxmodx,Metamod 放在cstrike/addons/metamod。很多人解压时直接把addons丢到根目录,结果 Metamod 根本扫不到。
我习惯在动手前先列一个目录对照表,避免放错:
| 文件/目录 | 应放位置 | 说明 |
|---|---|---|
addons/amxmodx | cstrike/addons/amxmodx | AMXX 核心与插件 |
addons/metamod | cstrike/addons/metamod | Metamod 加载器 |
liblist.gam | cstrike/liblist.gam | 需修改加载项 |
plugins.ini | cstrike/addons/amxmodx/configs/plugins.ini | 插件启用列表 |
modules.ini | cstrike/addons/amxmodx/configs/modules.ini | 模块启用列表 |
amxx.cfg | cstrike/addons/amxmodx/configs/amxx.cfg | 全局参数 |
这张表建议存一份,后面改配置时直接对着找,比在目录里翻要快得多。Linux 下还要注意文件权限,amxmodx_mm_i386.so和amxmodx/*.so模块需要可读可执行,我一般统一chmod -R 755 addons,省得后面一个个补。
2.3 语言包选择:中文、繁體中文、英文到底怎么切
AMXX 1.8.1 的语言文件在addons/amxmodx/data/lang下,文件名类似common.txt、admincmd.txt、plmenu.txt。每个文件里按语言代码分段,[en]是英文,[cn]是简体中文,[tw]是繁體中文。切换语言不是替换文件,而是改amxmodx/configs/amxx.cfg里的amx_language参数。
常见做法是:
# 编辑 amxx.cfg,找到或添加这一行 amx_language "cn" # 简体中文;繁體中文用 "tw";英文用 "en"改完之后重启服务端,或者控制台执行amx_langmenu让玩家自己选。注意,如果语言文件里缺少对应段落,菜单会回退到英文,不会报错,但显示会混着来。我一般会先检查data/lang下文件是否完整,再改配置。
3. 安装落地:从解压到 Metamod 挂载的完整步骤
3.1 解压与文件放置:别让路径里的空格坑了你
拿到 AMXX 1.8.1 的压缩包后,先解压到一个临时目录,不要直接解压到服务端根目录。我见过有人解压时路径带空格,比如D:\CS Server\,结果 Metamod 的gamedll指向解析失败,服务端启动直接报Unable to load amxmodx_mm.dll。正确做法是先把服务端放在无空格、无中文的路径下,比如D:\hlds\或/home/hlds/。
解压后,把addons目录整体复制到cstrike下。如果之前没有addons,直接复制;如果已有 Metamod,只复制addons/amxmodx,然后确认addons/metamod已存在。复制完成后,检查cstrike/addons/amxmodx/dlls下是否有amxmodx_mm.dll(Windows)或amxmodx_mm_i386.so(Linux),这是核心动态库,缺了它后面全白搭。
# Linux 下复制并检查权限 cp -r addons/amxmodx /home/hlds/cstrike/addons/ chmod -R 755 /home/hlds/cstrike/addons/amxmodx ls -l /home/hlds/cstrike/addons/amxmodx/dlls/这段命令做三件事:复制 AMXX 目录、给整个目录可执行权限、列出核心库确认存在。权限不对时,服务端日志会提示Failed to load,但不会告诉你具体是权限问题,所以这一步别省。
3.2 修改 liblist.gam:让 Metamod 接管游戏 DLL
Metamod 要生效,必须改cstrike/liblist.gam。用文本编辑器打开,找到gamedll或gamedll_linux那一行,把它指向 Metamod 的库文件。Windows 下通常是:
gamedll "addons/metamod/dlls/metamod.dll"Linux 下是:
gamedll_linux "addons/metamod/dlls/metamod_i386.so"注意路径用正斜杠,不要用反斜杠。改完后保存,这一步是 Metamod 挂载 AMXX 的前提。如果liblist.gam里原本有gamedll指向mp.dll,直接替换掉,不要保留两行。
注意:有些整合包会自带
liblist.gam,覆盖前先备份原文件,万一 Metamod 加载失败,还能还原回去排查。
3.3 配置 Metamod 的 plugins.ini:挂上 AMXX
Metamod 自己的插件列表在cstrike/addons/metamod/plugins.ini。打开它,添加一行指向 AMXX 的核心库:
win32 addons/amxmodx/dlls/amxmodx_mm.dll linux addons/amxmodx/dlls/amxmodx_mm_i386.so这两行分别对应 Windows 和 Linux,服务端会自动选对应的那行。如果你只跑一种系统,可以只留一行。加完后保存,Metamod 启动时会按这个列表加载 AMXX。如果这行写错,日志里会出现metamod: plugins.ini相关报错,AMXX 完全不会启动。
我一般会在这个文件里保留注释,标明哪行是 AMXX,方便以后加其他 Metamod 插件时不会搞混。
3.4 启用模块与插件:modules.ini 和 plugins.ini 的取舍
AMXX 启动后,会读addons/amxmodx/configs/modules.ini和plugins.ini。modules.ini控制功能模块,比如fun、engine、fakemeta、cstrike、csx。很多插件依赖这些模块,没开就会报Module not found。
我一般会先开这几个基础模块:
fun engine fakemeta cstrike csx在modules.ini里去掉对应行前面的;注释即可。plugins.ini则是插件列表,默认已经有一些基础插件,比如admin.amxx、plmenu.amxx。你要加的第三方插件,把.amxx文件放到addons/amxmodx/plugins/,然后在plugins.ini里加一行文件名。
; 自定义插件示例 my_custom_plugin.amxx加完后重启服务端,控制台输入amxx plugins可以看到插件加载状态。如果某个插件显示bad load,多半是缺模块或编译版本不对。
4. 避坑与排查:装完不生效时先查这五处
4.1 现象:服务端启动报 “Unable to load amxmodx_mm”
原因通常是路径不对或权限不足。先确认liblist.gam里gamedll指向的是 Metamod 而不是 AMXX,AMXX 是由 Metamod 加载的,不是直接由游戏加载。然后检查addons/metamod/plugins.ini里 AMXX 那行路径是否和实际文件位置一致。Linux 下还要看.so文件是否有执行权限,ls -l看到-rw-r--r--就是没权限,chmod 755补上。
4.2 现象:AMXX 启动了,但插件列表是空的
先看plugins.ini里插件名是否写对,包括大小写。AMXX 在 Linux 下区分大小写,Admin.amxx和admin.amxx是两个结果。然后确认插件文件确实在plugins/目录下。如果插件依赖模块,modules.ini里没开对应模块,插件会加载失败但不会让 AMXX 崩溃,只是列表里看不到。控制台amxx modules可以看模块状态。
4.3 现象:菜单显示乱码或中英文混杂
这是语言包问题。先确认amxx.cfg里amx_language设成了cn或tw,然后检查data/lang下对应文件是否包含该语言段落。有些第三方插件自带语言文件,需要单独放到data/lang下,否则它的菜单会回退到英文。我一般会统一用一套语言文件,避免混用。
4.4 现象:玩家进服后权限不对,管理员菜单打不开
检查addons/amxmodx/configs/users.ini,管理员账号格式是"名字" "密码" "权限" "账号类型"。常见错误是权限字母写错,比如abcdefghijklmnopqrstu里漏了某个字母,导致部分命令不可用。另外,amxx.cfg里amx_default_access如果设得太高,普通玩家也会被当成管理员,这个参数一般留空或设z。
4.5 现象:服务端运行一段时间后崩溃,日志指向 AMXX
先看addons/amxmodx/logs/下的日志,AMXX 会记录错误堆栈。常见原因是某个插件和当前 AMXX 版本不兼容,或者模块冲突。我一般会先禁用最近加的插件,用二分法排查。另外,amxmodx_mm的版本要和 Metamod 匹配,混用不同版本的 Metamod 和 AMXX 也可能导致随机崩溃。
5. 验证跑通:用三条命令确认环境真的活了
装完之后别急着开服,先本地起一个监听端口,用控制台验证。我习惯按这个顺序走一遍:
第一步,启动服务端,观察控制台输出。正常情况会看到 Metamod 版本信息,然后是 AMXX 的启动横幅,类似AMX Mod X 1.8.1。如果只看到 Metamod 没有 AMXX,回到第 3.3 节检查plugins.ini。
第二步,在服务端控制台输入:
amxx version amxx modules amxx pluginsamxx version会显示 AMXX 版本和编译时间,确认是 1.8.1。amxx modules列出已加载模块,前面开了的fun、engine、fakemeta、cstrike、csx应该都是running。amxx plugins列出插件,看你要的插件是否在列表里且状态为running。如果某个插件显示bad load,看它后面括号里的原因,通常是Module not found或Plugin file not found。
第三步,进游戏实测。用管理员账号进服,按Y输入amx_help或amx_menu,看菜单是否正常弹出、语言是否正确。再试一个具体插件功能,比如amx_slap或amx_map,确认命令有响应。如果菜单能开但命令没反应,多半是权限或模块问题,回到第 4.4 节查users.ini。
我还会额外看一眼addons/amxmodx/logs/下当天的日志,确认没有反复出现的错误行。有时候插件能跑,但日志里一直在刷某个警告,这种隐患早发现比晚发现好。
从那以后我每次部署 AMXX,不管多急,都会强制走一遍amxx modules和amxx plugins这两条命令,确认模块和插件状态都对,再进游戏点菜单。这个习惯帮我省掉了至少三次“装完看着正常、进服才发现插件没加载”的返工。希望帮到你。
本文还有配套的精品资源,点击获取