write down design of this mutator

diff --git a/qcsrc/server/mutators/mutator_new_toys.qc b/qcsrc/server/mutators/mutator_new_toys.qc
new file mode 100644 (file)
index 0000000..f74c01d
--- /dev/null
+++ b/qcsrc/server/mutators/mutator_new_toys.qc
@@ -0,0 +1,58 @@
+/*
+
+CORE    laser   nex     lg      rl      cry     gl      elec    hagar   fireb   hook
+                                                                       minsta  porto
+                                                                       tuba
+
+NEW             rifle   hlac    minel                           seeker   
+IDEAS                                   OPEN    flak    OPEN            FUN FUN FUN FUN
+
+
+
+How this mutator works:
+ =======================
+
+When a gun tries to spawn, this mutator is called. It will provide alternate
+default values of weaponreplace lists.
+
+Entity:
+
+{
+"classname" "weapon_nex"
+"new_toys" "rifle"
+}
+-> This will spawn as Rifle in this mutator ONLY, and as Nex otherwise.
+
+{
+"classname" "weapon_nex"
+"new_toys" "nex rifle"
+}
+-> This will spawn as either Nex or Rifle in this mutator ONLY, and as Nex otherwise.
+
+{
+"classname" "weapon_nex"
+"new_toys" "nex"
+}
+-> This is always a Nex.
+
+If the map specifies no "new_toys" argument
+
+There will be two default replacements selectable: "replace all" and "replace random".
+In "replace all" mode, e.g. Nex will have the default replacement "rifle".
+In "replace random" mode, Nex will have the default replacement "nex rifle".
+
+The New Toys guns do NOT get a spawn function, so they can only ever be spawned
+when this mutator is active.
+
+Likewise, warmup, give all, give ALL and impulse 99 will not give them unless
+this mutator is active.
+
+Outside this mutator, they still can be spawned by:
+- setting their start weapon cvar to 1
+- give weaponname
+- weaponreplace
+
+Also, this mutator performs the default replacements on the DEFAULTS of the
+start weapon selection.
+
+*/