]> git.pond.sub.org Git - empserver/blob - src/lib/player/empmod.c
(player_coms): Document second argument of launch.
[empserver] / src / lib / player / empmod.c
1 /*
2  *  Empire - A multi-player, client/server Internet based war game.
3  *  Copyright (C) 1986-2005, Dave Pare, Jeff Bailey, Thomas Ruschak,
4  *                           Ken Stevens, Steve McClure
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, write to the Free Software
18  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  *  ---
21  *
22  *  See the "LEGAL", "LICENSE", "CREDITS" and "README" files for all the
23  *  related information and legal notices. It is expected that any future
24  *  projects/authors will amend these files as needed.
25  *
26  *  ---
27  *
28  *  empmod.c: List all commands for Empire
29  * 
30  *  Known contributors to this file:
31  *     Dave Pare, 1986
32  *     Jeff Bailey
33  *     Thomas Ruschak, 1992
34  *     Ken Stevens, 1995
35  *     Steve McClure, 1996-2000
36  */
37
38 #include "misc.h"
39 #include "com.h"
40 #include "nat.h"
41 #include "file.h"
42 #include "commands.h"
43 #include "version.h" /* need to OBSOLETE hidden command */
44
45
46 struct cmndstr player_coms[] = {
47 /*  command form                       cost     addr    permit */
48     {"accept  [as-COUNTRY]", 0, acce, C_MOD, NORM},
49     {"add <NAT> <NAME> <REP> <STATUS> <c|w|i>", 0, add, C_MOD, GOD},
50     {"announce {message}", 0, tele, C_MOD, VIS},
51     {"anti <SECT>", 3, anti, C_MOD, NORM + MONEY + CAP},
52     {"apropos <topic>", 0, apro, 0, VIS},
53     {"arm <PLANE> <NUKETYPE> <airburst?>", 3, arm, C_MOD,
54      NORM + MONEY + CAP},
55     {"army <ARMY> <UNITS>", 0, army, C_MOD, NORM},
56     {"assault <to-SECT> <from-SHIP> [<forts?> <ships?> <arty?> <planes?>]",
57      3, assa, C_MOD, NORM + MONEY + CAP},
58     {"attack <SECT> [<forts?> <ships?> <arty?> <planes?>]", 3, atta, C_MOD,
59      NORM + MONEY + CAP},
60     {"bdes <SECTS> <type>", 0, bdes, C_MOD, NORM},
61     {"bestpath <SECTS> <SECTS>", 0, best, 0, NORM},
62     {"bmap <SECTS|UNIT> [s|l|p|r|t|*|h]", 0, map, C_MOD, NORM},
63     {"board <to-SHIP> [<from-SHIP>|<from-sector>]", 3, boar, C_MOD,
64      NORM + MONEY + CAP},
65     {"bomb <bomber-PLANES> <fighter-PLANES> <pin|strat> <ap-SECT> <PATH|DESTINATION>", 2, bomb, C_MOD, NORM + MONEY + CAP},
66     {"break {sanctuary}", 1, brea, C_MOD, SANCT},
67     {"budget [<sector type|P|S|L|A|M|N|C> <PRIORITY|~>]", 1, budg, 0,
68      NORM},
69     {"build <s|l|b|p|n|t> <SECTS> <type|dir> [<number> <tech> <sure?>]", 1,
70      buil, C_MOD, NORM + MONEY + CAP},
71     {"buy <COMM> <LOT#> <BID/UNIT> <DEST>", 1, buy, C_MOD,
72      CAP + NORM + MONEY},
73     {"bye {log-off}", 0, quit, 0, VIS},
74     {"capital <SECT>", 0, capi, C_MOD, NORM},
75     {"cargo <SHIPS>", 0, carg, 0, NORM},
76 #ifdef CEDE_IS_ALLOWED
77     {"cede <SECTS|SHIPS> <COUNTRY> [se|sh]", 639, cede, C_MOD, NORM},
78 #endif /* CEDE_IS_ALLOWED */
79     {"census <SECTS>", 0, cens, 0, VIS},
80     {"change <country|representative> <NAME>", 0, chan, C_MOD, VIS},
81     {"coastwatch <SECTS>", 1, coas, C_MOD, NORM + CAP},
82     {"collect <LOAN> <SECT>", 2, coll, C_MOD, NORM + MONEY + CAP},
83     {"commodity <SECTS>", 0, comm, 0, VIS},
84     {"consider <loan|treaty> <LOAN/TREATY> <acc|decl|post>", 1, cons,
85      C_MOD, NORM + CAP},
86     {"convert <SECTS> <NUM> [sure?]", 2, conv, C_MOD, NORM + MONEY + CAP},
87     {"country <NATS>", 0, coun, 0, NORM},
88     {"cutoff <SECTS>", 0, cuto, C_MOD, NORM},
89     {"declare <all|friend|neut|hos|war> <NATS>", 2, decl, C_MOD,
90      NORM + CAP},
91     {"deliver <COMM> <SECTS> [q|<THRESH>] [<DIR>]", 1, deli, C_MOD, NORM},
92     {"demobilize <SECTS> <NUM> <active-reserve?> [sure?]", 1, demo, C_MOD,
93      NORM + CAP},
94     {"designate <SECTS> <type> [sure?]", 1, desi, C_MOD, NORM},
95     {"disable", 0, disa, C_MOD, GOD},
96     {"disarm <PLANE>", 2, arm, C_MOD, NORM + MONEY + CAP},
97     {"distribute <SECTS> <DISTSECT|.|h>", 1, dist, C_MOD, NORM},
98     {"drop <cargo-PLANES> <fighter-PLANES> <ap-SECT> <PATH|DESTINATION> <COMM>", 1, drop, C_MOD, NORM + MONEY + CAP},
99     {"dump <SECTS> [<fields>]", 0, dump, 0, NORM},
100     {"echo [<string>]", 0, echo, 0, NORM},
101     {"edit <country|land|unit|ship|plane|nuke> [<KEY> <VALUE>]...", 0,
102      edit, C_MOD, GOD},
103     {"enable", 0, enab, C_MOD, GOD},
104     {"enlist <SECTS> <NUM>", 2, enli, C_MOD, NORM + MONEY + CAP},
105     {"execute <INPUT FILE>", 0, execute, 0, VIS},
106     {"explore <c|m> <SECT> <NUM> <PATH|DESTINATION>", 1, explore, C_MOD,
107      NORM + MONEY + CAP},
108     {"financial", 0, fina, 0, NORM},
109     {"fire <TYPE> <from-SECTS | SHIPS | UNITS> [TO-SECT | SHIP]", 1, multifire, C_MOD, NORM + MONEY + CAP},
110     {"flash <COUNTRY> [<message>]", 0, flash, 0, VIS},
111     {"fleetadd <FLEET> <SHIPS>", 0, flee, C_MOD, NORM},
112     {"fly <cargo-PLANES> <fighter-PLANES> <ap-SECT> <PATH|DESTINATION> <COM>", 2, fly, C_MOD, NORM + MONEY + CAP},
113     {"follow <leader> <SHIPS>", 1, foll, C_MOD, NORM + CAP},
114     {"force <delay time>", 0, force, C_MOD, GOD},
115     {"fortify <UNITS> <MOB>", 1, fort, C_MOD, NORM},
116     {"fuel <s|l> <SHIP/FLEET | UNIT/ARMY> <AMOUNT> [<OILER>]", 1, fuel,
117      C_MOD, NORM},
118     {"give <COMM> <SECT> <NUM>", 0, give, C_MOD, GOD},
119     {"grind <SECT> <NUM>", 1, grin, C_MOD, NORM + MONEY + CAP},
120     {"harden <PLANES> <NUM>", 2, hard, C_MOD, NORM + MONEY + CAP},
121     {"help <topic>", 0, info, 0, VIS},
122     {"headlines [days]", 0, head, C_MOD, VIS},
123     /* 
124      * OBSOLETE
125      * once hidden command is removed, also remove the hidden code in peek.c
126      */
127     {"hidden <SECTS>", 0, peek, 0, GOD},
128     {"improve <road|rail|defense> <SECTS> <NUM>", 1, improve, C_MOD,
129      NORM + MONEY + CAP},
130     {"info <topic>", 0, info, 0, VIS},
131     {"land <UNITS>", 0, land, C_MOD, NORM},
132     {"launch <PLANES> <SECT|SHIP>", 3, laun, C_MOD, NORM + MONEY + CAP},
133     {"lboard <to-LAND> [<from-sector>]", 3, lboa, C_MOD,
134      NORM + MONEY + CAP},
135     {"lcargo <UNITS>", 0, lcarg, 0, NORM},
136     {"ledger <LOANS>", 0, ledg, 0, NORM},
137     {"level <SECTS>", 0, leve, 0, NORM},
138     {"list of commands", 0, explain, 0, VIS},
139     {"lbmap <SECTS|UNIT> [s|l|p|r|t|*|h]", 0, map, C_MOD, NORM},
140     {"ldump <UNITS> [<fields>]", 0, ldump, 0, NORM},
141     {"lload <COMM|\"land\"|\"plane\"> <UNITS> <NUM|UNITS|PLANES>", 1,
142      lload, C_MOD, NORM + CAP},
143     {"llookout <UNITS>", 1, llook, 0, NORM + CAP},
144     {"lmap <SECTS|UNIT> [s|l|p|*|h]", 0, map, C_MOD, NORM},
145     {"lmine <UNITS>", 2, landmine, C_MOD, NORM + MONEY + CAP},
146     {"load <COMM|\"land\"|\"plane\"> <SHIPS> <NUM|UNITS|PLANES>", 1, load,
147      C_MOD, NORM + CAP},
148     {"lookout <SHIPS>", 1, look, 0, NORM + CAP},
149     {"lost", 0, lost, 0, NORM},
150     {"lradar <UNITS | SECTS>", 1, rada, 0, NORM + CAP},
151     {"lrange <UNITS> <range>", 1, lrange, C_MOD, NORM + CAP},
152     {"lretreat <UNITS|ARMY> <PATH> [i|h|b|c]", 1, lretr, C_MOD,
153      NORM + CAP},
154     {"lstat <UNITS>", 0, lsta, C_MOD, NORM},
155     {"ltend <COMM> <tender-SHIPS> <NUM> <UNITS>", 1, ltend, C_MOD,
156      NORM + CAP},
157     {"lunload <COMM|\"land\"|\"plane\"> <UNITS> <NUM|UNITS|PLANES>", 1,
158      lload, C_MOD, NORM + CAP},
159     {"market <COMM|\"all\">", 0, mark, 0, VIS},
160     {"map <SECTS|SHIP> [s|l|p|*|h]", 0, map, C_MOD, VIS},
161     {"march <UNITS> <PATH|DESTINATION>", 1, march, C_MOD, NORM + CAP},
162     {"mine <SHIPS>", 2, mine, C_MOD, NORM + MONEY + CAP},
163     {"mission <type> <PLANES|SHIPS|UNITS> <mission type> <op sect> [<radius>]", 2, mission, C_MOD, NORM + CAP},
164     {"mobupdate <MINUTES|check>", 0, mobupdate, C_MOD, GOD},
165     {"morale <UNITS> <retreat%>", 1, morale, C_MOD, NORM + CAP},
166     {"motd", 0, show_motd, C_MOD, VIS},
167     {"move <COMM> <SECT> <NUM> <PATH|DESTINATION>", 1,
168      move, C_MOD, NORM + CAP},
169     {"mquota <SHIPS> <value>", 2, mobq, C_MOD, NORM + CAP},
170     {"name <SHIPS> <NAME>", 0, name, C_MOD, NORM},
171     {"nation", 0, nati, 0, VIS},
172     {"navigate <SHIPS> <PATH|DESTINATION>", 1, navi, C_MOD, NORM + CAP},
173     {"ndump <SECTS>", 0, ndump, 0, NORM},
174     {"newcap <NAT> [<SECTOR>]", 0, new, C_MOD, GOD},
175     {"neweff <SECTS>", 0, newe, C_MOD, NORM},
176     {"newspaper [days]", 0, news, 0, VIS},
177     {"nmap <SECTS|SHIP> [s|l|p|*|h]", 0, map, C_MOD, VIS},
178     {"nuke <SECTS>", 0, nuke, 0, NORM},
179     {"offer <loan|treaty> <NAT> [<NUM> <DAYS> <IRATE>]", 1, offe, C_MOD,
180      NORM + MONEY + CAP},
181     {"offset <SECT|NAT>", 0, offs, C_MOD, GOD},
182     {"order <SHIPS> <c|s|r|d|l> ", 1, orde, C_MOD, NORM + CAP},
183     {"origin <SECT>", 1, orig, C_MOD, NORM},
184     {"paradrop <cargo-PLANES> <fighter-PLANES> <ap-SECT> <PATH|DESTINATION>", 3, para, C_MOD, NORM + MONEY + CAP},
185     {"path <SECT>", 0, path, 0, NORM},
186     {"payoff <SHIPS>", 0, payo, C_MOD, NORM},
187     {"pbmap <SECTS|UNIT> [s|l|p|r|t|*|h]", 0, map, C_MOD, NORM},
188     {"pboard <PLANES>", 3, pboa, C_MOD, NORM + MONEY + CAP},
189     {"pdump <PLANES> [<fields>]", 0, pdump, 0, NORM},
190     {"peek <SECTS>", 0, peek, 0, GOD},
191     {"plane <SECTS>", 0, plan, 0, NORM},
192     {"players", 0, play, 0, VIS},
193     {"pmap <SECTS|UNIT> [s|l|p|*|h]", 0, map, C_MOD, NORM},
194     {"power [[\"new\" [<NUMBER OF COUNTRIES>]] | [\"country\" <COUNTRY NUMBER>]]", 0, powe, C_MOD, VIS},
195     {"pray", 0, tele, C_MOD, NORM},
196     {"production <SECTS>", 0, prod, 0, NORM},
197     {"pstat <PLANES>", 0, pstat, 0, NORM},
198     {"qorder <SHIPS>", 0, qorde, C_MOD, NORM + CAP},
199     {"quit", 0, quit, 0, VIS},
200     {"radar <SHIPS | SECTS>", 1, rada, 0, NORM + CAP},
201     {"range <PLANES> <range>", 1, range, C_MOD, NORM + CAP},
202     {"read [yes|no|<CNUM/CNAME>]", 0, rea, C_MOD, VIS},
203     {"realm <number> [<SECTS>]", 0, real, C_MOD, NORM},
204     {"recon <spy-PLANES> <fighter-PLANES> <ap-SECT> <PATH|DESTINATION>", 3,
205      reco, C_MOD, NORM + MONEY + CAP},
206     {"retreat <SHIPS|FLEET> <PATH> [i|t|s|h|b|d|u|c]", 1, retr, C_MOD,
207      NORM + CAP},
208     {"relations  [as-COUNTRY]", 0, rela, 0, VIS},
209     {"reject <reject|accept> <announcements|mail|treaties|loans> <NAT>", 2,
210      reje, C_MOD, NORM},
211     {"repay <LOAN> <NUM>", 1, repa, C_MOD, NORM + MONEY + CAP},
212     {"report <NATS>", 0, repo, 0, VIS},
213     {"reset <lot #> <0|price>", 1, rese, C_MOD, NORM + CAP},
214     {"resource <SECTS>", 0, reso, 0, NORM},
215     {"route <COMM> <SECTS>", 1, rout, 0, NORM},
216     {"sabotage <UNITS>", 1, sabo, C_MOD, NORM + MONEY + CAP},
217     {"sail <SHIPS> <PATH>", 1, sail, C_MOD, NORM + CAP},
218     {"satellite <PLANE> [<se|sh|l> [?cond&cond&...]]", 1, sate, 0,
219      NORM + MONEY + CAP},
220     {"sbmap <SECTS|UNIT> [s|l|p|r|t|*|h]", 0, map, C_MOD, NORM},
221     {"scrap <s|p|l> <SHIPS|PLANES|UNITS>", 2, scra, C_MOD,
222      NORM + MONEY + CAP},
223     {"scuttle <s|p|l> <SHIPS|PLANES|UNITS>", 5, scut, C_MOD, NORM + CAP},
224     {"sdump <SHIPS> [<fields>]", 0, sdump, 0, NORM},
225     {"sect <SECTS>", 0, sct, 0, NORM},
226     {"sell <COMM> <SECTS> <NUM> <NUM>", 1, sell, C_MOD, NORM + CAP},
227     {"set <TYPE> <LIST> <PRICE>", 1, set, C_MOD, NORM + CAP},
228     {"setsector <TYPE> <SECTS> <NUM>", 0, setsector, C_MOD, GOD},
229     {"setresource <TYPE> <SECTS> <NUM>", 0, setres, C_MOD, GOD},
230     {"shark <LOAN>", 25, shark, C_MOD, NORM + MONEY + CAP},
231     {"sharebmap <CNUM/CNAME> <SECTS> [<des>]", 0, shar, C_MOD, NORM},
232     {"ship <SHIPS>", 0, shi, 0, NORM},
233     {"shoot <c|u> <SECTS> <NUMBER>", 3, shoo, C_MOD, NORM + MONEY + CAP},
234     {"show <TYPE> <\"build\"|\"stats\"|\"cap\"> [<tech>]", 0, show, 0,
235      VIS},
236     {"shutdown [<minutes>] <disable update?>", 0, shut, 0, GOD},
237     {"sinfrastructure <SECTS>", 0, sinfra, 0, VIS},
238     {"skywatch <SECTS>", 1, skyw, C_MOD, NORM + CAP},
239     {"smap <SECTS|UNIT> [s|l|p|*|h]", 0, map, C_MOD, NORM},
240     {"sonar <SHIPS> <brief?>", 1, sona, C_MOD, NORM + CAP},
241     {"sorder <SHIPS>", 0, sorde, C_MOD, NORM + CAP},
242     {"spy <SECTS>", 1, spy, C_MOD, NORM + CAP},
243     {"sstat <SHIPS>", 0, sstat, 0, NORM},
244     {"start <SECTS>", 1, start, C_MOD, NORM + CAP},
245     {"starvation [<SECTS>|l <UNITS>|s <SHIPS>]", 0, starve, 0, NORM},
246     {"stop <SECTS>", 1, stop, C_MOD, NORM + CAP},
247     {"strength <SECTS>", 1, stre, C_MOD, NORM},
248     {"supply <LAND UNITS>", 1, supp, C_MOD, NORM + CAP},
249     {"survey <SELECTOR> <SECTS>", 0, surv, 0, NORM + CAP},
250     {"swapsector <SECT> <SECT>", 0, swaps, C_MOD, GOD},
251     {"sweep <sweep-PLANES> <fighter-PLANES> <ap-SECT> <PATH|DESTINATION>",
252      3, reco, C_MOD, NORM + MONEY + CAP},
253     {"telegram <NAT>", 0, tele, C_MOD, NORM},
254     {"tend <COMM|\"land\"> <tender-SHIPS> <NUM|UNIT> <dest-SHIPS>", 1,
255      tend, C_MOD, NORM + CAP},
256     {"territory <SECTS> <NUMBER> [<FIELD>]", 0, terr, C_MOD, NORM},
257     {"test <COMM> <SECT> <NUM> <PATH|DESTINATION>", 1,
258      move, 0, NORM + CAP},
259     {"threshold <COMM> <SECTS> <THRESH>", 1, thre, C_MOD, NORM},
260     {"toggle [inform|flash|beep|coastwatch|sonar|techlists] [on|off]", 0,
261      togg, C_MOD, VIS},
262     {"torpedo <submarine-SHIPS> <target-SHIP>", 3, torp, C_MOD,
263      NORM + MONEY + CAP},
264     {"trade", 1, trad, C_MOD, NORM + CAP + MONEY},
265     {"transport <\"nuke\"|\"plane\"> <SECT|PLANES> [<NUKETYPE> <number>] <PATH|DESTINATION>", 1, tran, C_MOD, NORM + CAP},
266     {"treaty <TREATIES>", 0, trea, 0, NORM + MONEY + CAP},
267     {"turn <\"on\"|\"off\"|\"mess\">", 0, turn, C_MOD, GOD},
268     {"unload <COMM|\"land\"|\"plane\"> <SHIPS> <NUM|UNIT|PLANE>", 1, load,
269      C_MOD, NORM + CAP},
270     {"unsail <SHIPS>", 1, sail, C_MOD, NORM + CAP},
271     {"update", 0, upda, 0, VIS},
272     {"upgrade <s|p|l> <SHIPS|PLANES|UNITS>", 1, upgr, C_MOD,
273      NORM + MONEY + CAP},
274     {"version", 0, vers, 0, VIS},
275     {"wait", 0, wai, C_MOD, GOD},
276     {"wall [<message>]", 0, wall, C_MOD, NORM},
277     {"wingadd <WING> <PLANES>", 1, wing, C_MOD, NORM},
278     {"wipe <SECTS>", 1, wipe, C_MOD, NORM},
279     {"wire [yes|no|<days>]", 0, rea, C_MOD, VIS},
280     {"work <LAND UNITS> <AMOUNT>", 1, work, C_MOD, NORM + MONEY + CAP},
281     {"xdump [<TABLE-KIND>] <TABLE> [<ROWS>]", 0, xdump, 0, NORM},
282     {"zdone <y|n|c>", 0, zdon, C_MOD, NORM},
283     {0, 0, 0, 0, 0}
284 };