Login
User Name:

Password:



Register

Forgot your password?
IPv6
Jan 25, 2025 10:45 pm
By Samson
mudstrlcpy and mudstrlcat
Jan 18, 2025 5:23 pm
By Samson
I3 and IMC
Jan 17, 2025 9:35 pm
By Samson
AFKMud 2.5.1
Jan 17, 2025 2:22 pm
By Samson
Array out of bounds ?
Jan 16, 2025 4:48 am
By Remcon
SmaugFUSS 1.9.7
Author: Various
Submitted by: Samson
AFKMud 2.5.1
Author: AFKMud Team
Submitted by: Samson
Kayle's Weather Code for AFKMud
Author: Kayle
Submitted by: Samson
AFKMud 2.5.0
Author: AFKMud Team
Submitted by: Samson
SWFotEFUSS 1.5.2
Author: Various
Submitted by: Samson
Users Online
Anthropic, GPTBot, AhrefsBot, Yandex

Members: 0
Guests: 3
Stats
Files
Topics
Posts
Members
Newest Member
503
3,811
19,714
589
xhuul

» SmaugMuds » Codebases » AFKMud Support & Development » How do I add new commands?
Forum Rules | Mark all | Recent Posts

How do I add new commands?
< Newer Topic :: Older Topic > Mini-guide

Pages:<< prev 1 next >>
Post is unread #1 Jan 6, 2004 8:11 am   
Go to the top of the page
Go to the bottom of the page

Samson
Black Hand
GroupAdministrators
Posts3,706
JoinedJan 1, 2002

 
Since this gets asked alot, I figured I'd improvise a short hack guide to this.

Most Smaug bases require 4 things to add a new command:

1. The do_fun code for the command itself
2. A DECLARE_DO_FUN line in mud.h.
3. 2 entries in tables.c.
4. Use of the cedit command to activate it.

AFKMud does not require steps 2 and 3, but there is a difference in how step 1 needs to be done. For a command to work, it must be defined as a CMDF instead of a void.

Example:

void do_something( CHAR_DATA *ch, char *argument )

The above is what would work for Smaug. For AFKMud, use the following instead:

CMDF do_something( CHAR_DATA *ch, char *argument )

The main difference being the use of the CMDF macro. This was necessary in order to get g++ to accept the use of the dlsym code while also retaining compatibility with plain gcc for those who prefer that. The details aren't terribly important to know.

Step 4 of the process is the same:

cedit something create

or

cedit something create do_something

If you get an error that do_something is not found, then the source code is either missing or the code is using void instead of CMDF.

Any snippets which still use the void declarartion for do_something will need to be changed to CMDF format to make them work as well.

Pages:<< prev 1 next >>