首页 > 代码库 > [MUD]MUDLIB详解/MUDOS运行流程/最小MUDLIB/mud文件结构
[MUD]MUDLIB详解/MUDOS运行流程/最小MUDLIB/mud文件结构
现在大部分中文MUD都是在东方故事(esII)基础上发展起来的,其目录结构基本一样,
也有个别MUD为了标新立异对个别目录换了个名字以示不同,但其实质没有什么变化。
这个做的最可恶的是xkx,把一个好好的daemon目录换成了一个不土不洋的kungfu,
里边却还是skill,condition这些洋名,简直让人faint!我实在看不出这种修改有什么好处,
除了添麻烦(xkx对一些命令的汉化,什么cha,du...也是如此)。不过,
也有一些是为了系统更合理而修改的。
对MUDLIB目录的解释已经有许多版本了,基本也没什么区别,下边是我的解释,
以我自己整理的一份MUDLIB为基础,如果有目录不同的地方适当贯通就是了。
/adm 这里是最基本,最底层的程序,是整个MUD的控制枢纽。
这个目录只有admin权限可以修改。
/adm/daemons 守护程序目录。守护程序是指游戏中频繁调用的控制类程序,
MUD里各种基本功能都是由这些程序控制的。这些程序一般在游戏一启动就自动载入内存。
按照unix下文件命名习惯,这里的程序多以d.c结尾,
比如combatd.c就是控制战斗的程序。另外由于这些程序调用非常频繁,
一般都做了宏定义(查看/include/globals.h),例如/adm/daemons/combatd.c
定义为COMBAT_D,在其它程序里可以适用这些宏定义代替这些文件名。
/adm/etc 系统配置目录,此目录定义为CONFIG_DIR 这里放的是游戏的系统文档文件,
比如游戏的欢迎画面,巫师列表,BAN掉的IP记录等。
/adm/obj 这里只有两个文件,但却是整个MUD最重要的东西。
master.c:这是MudOS主控物件,也就是整个MUD的总司令。
simul_efun.c:防真函数加载精灵,这是MUD启动时第一个要载入的东西。
所谓efun,是指系统函数,也就是mudos中定义的函数。
这些函数不必做任何说明可以在MUD的任何程序里直接调用,
而且由于他们是预先定义的,也就是mudos早已经知道他们是做什么的,
所以比其它在MUDLIB里定义的函数执行效率要高。但他们的缺点是修改非常不方便,
对任何一个efun函数的修改必须重新编译mudos才能生效。因此,
在MUDLIB中又有了防真函数的定义,也就是simul_efun,
这些函数的作用跟efun完全一样,不同的是他们定义在UDLIB中,可以随时修改,
但必须重新启动游戏才能生效。
顺便讲一下一个MUD启动的过程,MUD启动的初始化过程分以下几步:
1.载入防真函数simul_efun
2.载入主控物件master,这里是调用master的create()函数将其载入内存。
3.载入需要预先载入的守护程序,这里调用master的preload()函数,
需要预先载入的文件定义在/adm/etc/preload里。
4.MUD进入多用户状态,允许玩家登录。
以上过程必须正确无误的执行完,否则游戏无法正确启动。
master.c和simul_efun.c这两个文件只能在游戏启动时由mudos自动载入,
不可以在游戏中用update的方法载入,而且这两个物件也不
允许非ROOT权限的物件摧毁(destruct)它,因为他们的摧毁就等于游戏关闭 。
/adm/simul_efun 防真函数目录,这里放的是定义各类防真函数的文件,
这些文件由SIMUL_EFUN_OB(也就是/adm/obj/simul_efun)来载入内存。
/cmds 游戏命令目录,这里放的是游戏中可以使用的各种命令,
只有admin才可以修改这个目录
/cmds/adm 只有天神(admin)可以使用的命令
/cmds/arch 只有大巫师(arch)以上才可以使用的命令
/cmds/wiz 只有巫师(wizard)以上才可以使用的命令
/cmds/app 只有巫师学徒(wizard)以上才可以使用的命令
/cmds/imm 只有荣誉玩家(immortal)以上才可以使用的命令
/cmds/usr 只有普通玩家(player)以上才可以使用的命令
/cmds/std 所有生物(npc and player)都可以使用的命令命令目录采用子集格式,
权限高的命令完全包含权限低的命令,比如天神可以使用所有游戏命令,
普通玩家只能使用/cmds/usr和/cmds/std目录下的命令。
/data 游戏数据目录,只有arch以上权限才可以修改这个目录
/data/board 各个留言板的数据
/data/login 玩家登录数据
/data/user 玩家档案,呵呵,这里记录的是每个玩家的所有劳动成果
/data/npc 一些特殊npc的数据,比如商店老板
/data/daemon 重要的系统数据,比如emote词,英汉翻译词典
/data/mail 玩家信件
/feature 标准继承函数。只有admin才可以对这个目录进行修改这些函数是非常重要的,
是MUD里各种物件,包括玩家,NPC,物品,房间等的各种功能的标准定义,
这些函数反映了整个MUD的与众不同之处,一个好的MUDLIB必然要对这些函数进行优化。
而要设计新的程序,必须对这个目录所有文件有所了解。
/obj 系统物件,这是经常在MUD里被调用的各种物件。
这个目录下的物件被复制后跟调用他的物件具有相同的euid,
也就是说具有相同的权限,所以,这里的一个npc如果经admin编译后复制出来,
也具有了admin权限。这点非常重要,有些物件必须具有跟玩家相同的euid才能正常使用
,比如符纸。而出于安全考虑,这个目录下的物件不可以随便复制。
只有arch以上才可以修改此目录。
/obj/board 游戏中各个留言板
/obj/npc 一些特殊的NPC
/obj/sheet 各种符纸
/obj/weapons 兵器
/obj/misc 其它乱七八糟的东西,比如信箱等
/quest 游戏里各种任务quest的文件,此目录需要wizard以上权限才可以修改
/binaries 文件编译过程生成的二进制文件,此目录ROOT权限才可以修改
/d 区域目录,游戏的地图门派和NPC存放的地方。此目录wizard以上权限可以修改。
这里是整个MUDLIB最简单最常用的东西,也是玩家可以直接接触到的东西。
玩家所呆的任何一个房间都应该对应这个目录下的一个文件,
房间里每个NPC也都对应一个文件。这个目录下存在许多子目录,
分别对应游戏的不同区域(domain)。
/d/domain/npc 该区域中的npc
/d/domain/npc/obj 该区域中npc身上的物品
/d/domain/obj 该区域中的物品
/data_bak 档案备份目录,保存需要备份的重要数据。admin可以修改
/include 头文件目录,只有admin可以修改。这里放的是游戏中各个文件所需要的头文件,
其中以下几个特别重要:
globals.h:全局定义的头文件,这是一个特殊的头文件,
他不需要在任何一个文件里被调用,但是这里定义的所有变量可以在任何一个文件里直接使用。
这里一般用来定义非常重要的或者许多地方需要调用
的变量。对这个文件的修改必须重新启动游戏才可以生效。command.h:
这里定义的是各个权限等级所能够使用的命令目录,所以,除了admin,
应该绝对禁止任何人修改此文件。
/include/race 种族的头文件
/include/net 网络功能的头文件
/open 系统临时目录,ftp登陆目录,任何人都具有写权限。
/questobj FY3的task专门目录,存放各个task物品文件。wizard以上权限可以修改。
/u 巫师工作目录,存放各个巫师开发过程的半成品。
这里的子目录名只能为各个巫师的euid,
而只有对应euid的人才有对相应目录的修改权限。比如一个目录是lion,
那么只有lion这个ID或者比lion权限高的人
才可以修改它下边的内容。
/clone 物品目录,存放游戏中需要经常复制的各种物品,wizard以上权限可以写。
这个目录下的物品一般被其他地方复制(clone)出来,但他们的euid是固定的,
不会随调用它的物件的不同而改变,这就是这个目录和/obj目录的最大不同。
此目录arch以上等级可以修改
/clone/armor 装备
/clone/drug 药品
/clone/fruit 水果,水果跟食物的不同是吃了可以同时加食物和饮水,
而且有些水果具有养颜美容之功效。
/clone/liquid 容器,象酒袋茶壶一类
/clone/money 顾名思义,人见人爱的东西
/clone/user 玩家物件,包括login.c(link_ob)和user.c(body),
此目录只有admin可以修改
/clone/books 各种秘籍
/clone/food 吃的
/clone/gift 各种礼物,一般是好东东
/clone/weapon 兵器
/clone/misc 其他杂物,比如尸体,头颅。
/daemon 呵呵,这个目录为什么叫这个名字我一直没明白,看下边的说明吧。
此目录只有arch以上可以修改。
/daemon/skill 游戏中所有的技能
/daemon/condition 人物各种状态,比如中毒,恢复等。
/daemon/class 这个应该理解为“组织”或“工会”,是ESII从外国MUD里保留下来的东西,
不过随着中文MUD的发展,工会的概念逐渐被淡化,其含义已经跟以前完全不同,
现在他的意思有点象“身份”,比如道士,和尚,喇嘛,官兵,老百姓。。。。
个人有个人的身份。很多情况下,这个跟门派类似,但又不完全相同。
这里存放的是各种不同身份的人所具有的特殊东西,
不过现在一般用来存放各种特殊技能的特殊用法(perform)
/doc 文档。 游戏中的各种文本文件,arch以上可以修改
/doc/help 各种帮助文件
/doc/efuns 各种系统函数的用法
/doc/story 各种背景故事
/log 系统日记,记录游戏过程各种重要事件,是巫师处理纠纷和剔除bug的主要依据来源。
一个好的巫师应该养成经常看系统日记的习惯。本目录只有ROOT权限可以修改。
/p 玩家目录,这个目录下内容玩家具有写的权限。主要存放需要玩家修改的内容,
比如玩家房间,自创武功等。
/std 标准对象目录,游戏中各种标准物件,
只有admin可以修改游戏里其他物件都需要继承这里的相应文件。
/std/armor 装备物品的标准继承,比如衣服,盔甲等
/std/board 留言板
/std/char 生物的标准继承,MUD里的生物包含两种:玩家(player)和非玩家(
npc)他们都需要继承/std/char/char.c这个对象,
他们与其他物件的区别是具有心跳(heartbeat)。
/std/drug 药品的标准继承,其实这个现在一般不用了,这部分功能都放到了
/feature的相应文件里,保留这个是为了跟旧的系统兼容。
/std/item 物品的标准继承
/std/room 房间的标准继承
有人曾问房间和物品到底有什么区别?说实话,这个问题还真不好说,
这两个物件基本结构差不多,也没有什么可以区分的特征。
现在的常用判断方法是房间是没有环境(environment)的,但也不是所有物品
(包括生物)都有环境,所以,呵呵,这个问题还有待MUD程序的进一步完善,
现在基本上无法判断。
/std/skill 技能的标准继承
/std/weapon 武器的标准继承
/std/misc 其他物件,比如钱,符纸。
值得注意的是,/std这个目录跟一般MUDLIB的结构不太一样,
一般MUDLIB并没有如此归类存放,大家可以根据自己的认识加以判断。
以上是根据我的理解对各个目录的解释,未必是权威的说法,
只是为了让大家有所认识,如果有什么错误请指正。
作为刚入门的新巫师,准确理解各个目录的作用是非常重要的,
必须知道哪个目录下的东西是做什么的,哪个目录你可以去改,哪个目录你不能动。
一般来说,要成为一个合格的巫师,至少要花半月时间来“读”程序,
了解整个MUDLIB的结构,了解各个文件的作用
(未必要完全看懂,但至少应该知道他是干什么的),
这样不至于再以后的程序开放过程中不知道什么功能该如何实现,从而走许多弯路。
当你了解了整个MUDLIB后就可以试着自己写程序了,
一般你只能在自己的工作目录里写东西。刚开始不妨试着写一个简单的房间,
然后试着写一个简单的npc,然后试着把这个npc放到这个房间里。。。。。。
这样逐渐提高,你很快就成为一个合格的巫师了。
参考资料:烈火西游 http://218.200.132.6:6666/list.asp?id=248
--------------------------------------------
mudos运行流程
今天我看了站上的一些文章,加上查看原程序,把mudos启动后,程序运行的流程搞清楚了。小弟觉得只要有一个好的mudos,就可写出新的mudlib 框架。我拿用户连接来解释程序的运行流程。
在config.xxx文件中指出了master和global两个文件,这是十分重要的文件。
mudos启动后会加载上述两个文件(其它文件也有,但上述文件为主要 )
进入内存,mudos中定义了一些特殊的函数,例如create()、init()等等,
这些函数都是在特定事件中由mudos自动调用的。
当用户在port口请求连接的时候:
——mudos自动调用master.c中的connect()函数
——然后connect()函数调用 LOGIN_OB这个物件,[而LOGIN_OB是个物件常量,在global.h中定义LOGIN_OB 的值是"/clone/user/login.c",也就是说connect()调用了login.c这个物件]
——在login.c中有一些特殊函数,如果按照用户正确登陆的流程,mudos自动调用login.c中logon()这个特殊函数。
——在logon()中由调用LOGIN_D这一物件常量,LOGIN_D在global.h文件中所定义的值是"/adm/daemons/logind",
——于是 mudos又把logind.c调入内存并运行。
我们一般认为mudos在编译前在它的设置文件中定义了用户login的程序 路径及文件名,
编译后路径和文件名不可改,在用户连入的时候,mudos根据 路径自动启动用户登陆程序。
其实非也,mudos只是一个对mud进行低级支持 的程序。
我们可以利用mudos,完全抛弃已有的mudlib框架,进行新的创作。
这样 才能使中国的mud种类走向多样化。
-------------------------------------------=
最小Mudib有多大?
这个最小的是说能驱动MUDOS,能成功Connected.
现在以网上下载的单机专用MUDOS和其配制的config.cfg为标准说明:
先找一个单独的MUDOS运行,需要配置文件,加载config.cfg...运行后提示:open log/debug.log file failed.OK,根椐配置我们建目录:/log,再运行,现在提示:The simul_efun file adm/obj/simul_efun.c was not loaded.OK,我们建目录:/adm/obj,并在obj目录中建一个空文件simul_efun.c,再运行,现在是:adm/obj/simul_efun.c line 0: Cannot #i nclude globals.h
adm/obj/simul_efun.c line 1: parse error
No error handler for error: *Error in loading object ‘/adm/obj/simul_efun‘
program: (none), object: (none), ..file: (none)
The simul_efun (/adm/obj/simul_efun) and master (/adm/obj/master) objects must be loadable.
看来现要config.h文件,根椐配置文件,我们建一个目录:/include,并在此目录中加一个空文件globals.h,再运行:The master file /adm/obj/master was not loaded.,现在我们在obj目录中建一个空文件master.运行:No function get_root_uid() in master object; possibly the mudlib doesn‘t want PACKAGE_UIDS to be defined.看来空的master.c不行了,我们在master.c中加上如下语句:string get_root_uid() { return "Root"; }
string get_bb_uid() { return "Backbone"; }
string creator_file(string file) { return "Root"; },现在再运行,OK,MUDOS成功跑起来了.
但现在用zMUD连线connected后就lose了,怎么办,现在在master.c中加一如下语句:object connect(int port)
{
object ob;
ob = new(__DIR__"user.c");
return ob;
}.同时在master.c相同目录中新建一个空文件user.c,现在运行mudos,并连线,成功...
现在看看一共用了哪些文件和目录?
1. /log
2. /adm/obj/simul_efun.c
3. /include/globals.h
4. /adm/obj/master.c
5. /adm/obj/user.c
其中只有master.c中有内容,其它的都是空的,这5个加起来有多大?237字节,怎么样?
[MUD]MUDLIB详解/MUDOS运行流程/最小MUDLIB/mud文件结构