编辑“︁HowToAddCreaturesStendhal”︁（章节）

== Using the Balancer Utility ==

The balancer is a tool that suggests appropriate ATK, DEF, & optionally XP reward for creatures in the game. Before using the utility to balance a creature, the creature must be configured in an appropriate XML file located under <code>data/conf/creatures/</code>.

=== Eclipse ===

Steps:
# Open the debug or run configurations.
# Under "Java Application" press the "New launch configuration" button.
# "Main" tab:
## Under "Main class" set the value to "games.stendhal.tools.BalanceRPGame".
# "Classpath" tab:
## Select "User Entries".
## Press "Advanced".
## In the window that pops up select "Add Folders" & press "OK".
## Select the Stendhal project folder & press "OK".
# "Arguments" tab:
## Under "Program arguments" you can list (space separated) the creatures you want to test. If the creature you want to test contains whitespace in its name, you must surround its name with quotes ("). If you do not put anything in this field, the balancer will run through all registered creatures.
## There is currently one recognized argument for the "VM arguments section. That is "-Dshowxp". If this value is set, the output of the balancer will include a suggested XP reward value for defeating the creature.
# Run the balancer by pressing the "Debug" or "Run" button.

=== Command Line ===

<span style="color:green; font-style:italic;">'''NOTE:''' To execute the balancer CLASSPATH must include the following:</span>
<blockquote>
Linux/Unix:<br>
<blockquote><code>./build/build_stendhaltools/:./:./build/build_server/:./tests/:./libs/*</code></blockquote>

Windows:<br>
<blockquote><code>.\\build\\build_stendhaltools;.;.\\build\\build_server;tests;.\\libs\\*</code></blockquote>
</blockquote>

Steps:
# From your command line, navigate to the root directory of the Stendhal source.
# Before you can use the enemy balancer, the Stendhal server & tools must be compiled. If you have [https://ant.apache.org/ Apache Ant] installed, this can be accomplished by running: <code>ant compile_stendhaltools server_build</code>
# Execute the following command(s):
#* To run through all configured creatures/enemies:
#** <code>java -cp "./build/build_stendhaltools/:./:./build/build_server/:./tests/:./libs/*" games.stendhal.tools.BalanceRPGame</code>
#* For only specific creatures, append the creature names to the end of the command:
#** <code>java -cp "./build/build_stendhaltools/:./:./build/build_server/:./tests/:./libs/*" games.stendhal.tools.BalanceRPGame orc "mountain orc"</code>
#** <span style="color:green; font-style:italic;">'''NOTE:''' Creature names containing whitespace must be enclosed in quotes (").</span>
#* To display XP suggestion, add the <code>-Dshowxp</code> option:
#** <code>java -cp "./build/build_stendhaltools/:./:./build/build_server/:./tests/:./libs/*" -Dshowxp games.stendhal.tools.BalanceRPGame</code>

=== Ant Command Line ===

<span style="color:green; font-weight:bold; font-style:italic;">NOTES:</span>
* To run the balancer using the <code>ant</code> command, you will need to have [https://ant.apache.org/ Apache Ant] installed.
* Currently this method does ''NOT'' support running the balancer without any creature name arguments.
* Currently this method does ''NOT'' support displaying XP suggestion.

Steps:
# From your command line, navigate to the root directory of the Stendhal source.
# Execute the following command (replace "name" with the creature you want to balance):
#* <code>ant balance -Dcreature="name"</code>
#* Multiple creatures can be processed at once by simply adding multiple creature names separated with whitespace: <code>-Dcreature="lion tiger bear"</code>
#* Creature names containing whitespace '''''must''''' be enclosed within nested double or single quotes. Examples:
#** <code>-Dcreature="\"mountain orc\""</code> ''(single creature)''
#** <code>-Dcreature="'mountain orc'"</code> ''(single creature)''
#** <code>-Dcreature='"mountain orc"'</code> ''(single creature)''
#** <code>-Dcreature="'mountain orc' orc"</code> ''(multiple creatures)''

=== Implementing Output ===

# After the balancer has finished running its simulation, it will output suggested values for ATK, DEF, & XP (if the "-Dshowxp" option is set).
# Open the XML file where the creature is configured & use the suggested values to fine tune the creature's ATK, DEF, & XP values.


[[Stendhal | Back to Stendhal main wiki page]]

[[Category:Stendhal]]