X-Git-Url: https://troll.desast.re/troll.git/blobdiff_plain/a78210b2e4295eaf8dee8215d4ffe5e062b4efb3..734e04c8106926949ce97c993e065c98f0fd25ed:/config/statement_en.html

diff --git a/config/statement_en.html b/config/statement_en.html
index edffecf..a63199a 100644
--- a/config/statement_en.html
+++ b/config/statement_en.html
@@ -111,9 +111,11 @@
          <div class="title">Map Input</div>
          <div class="text">
            <p>
-             Your first line of input contains three space-separated
+             Your first line of input contains space-separated
              parameters:
-             <var>roadLength</var> <var>initialStones</var> <var>seed</var>
+             <var>roadLength</var> <var>initialStones</var>
+             <var>gameSeed</var> <var>gameSide</var>
+             <var>reserved1</var> &hellip; <var>reservedN</var>
            </p>
            <dl style="margin: 1em;">
              <dt>roadLength</dt>
@@ -133,6 +135,19 @@
                algorithms, and you're encouraged to do the same!  See
                examples section below for simple ways to achieve that.
              </dd>
+             <dt>gameSide</dt>
+             <dd style="margin-left: 6em;">
+               which side you're on, as <const>-1</const>
+               or <const>1</const>.  It's not supposed to make a
+               difference to how you handle the rest of the game, but
+               you can XOR it to your <code>gameSeed</code> to have a
+               (reproducible) random that doesn't mecessarily draw
+               when it plays against itself.
+             </dd>
+             <dt>reserved<em>N</em></dt>
+             <dd style="margin-left: 6em;">
+               one or more parameters, reserved for future use
+             </dd>
            </dl>
          </div>
        </div>
@@ -192,6 +207,37 @@
        </div>
      </div>
    </div>
+   <div class="statement-section statement-examples">
+     <h2>
+       <span class="icon icon-example">&nbsp;</span>
+       <span>Proper RNG seeding examples</span>
+     </h2>
+     <table>
+       <tr>
+         <th style="border-bottom: 2px dashed #f2bb13;">Language Family</th>
+         <th style="border-bottom: 2px dashed #f2bb13;">Sample</th>
+       </tr>
+       <tr>
+         <td style="border-bottom: 1px dashed #f2bb13;">JVM</td>
+         <td style="border-bottom: 1px dashed #f2bb13;"><code>
+             long mySecretSalt = 0x4242424242424242L;<br>
+             Random random = new Random(gameSeed ^ gameSide ^ mySecretSalt);
+         </code></td>
+       </tr>
+       <tr>
+         <td style="border-bottom: 1px dashed #f2bb13;">C, C++, Perl&hellip;</td>
+         <td style="border-bottom: 1px dashed #f2bb13;"><code>
+             srand(gameSeed ^ gameSide ^ 0xdeadb33f);<br>
+             std::srand(gameSeed ^ gameSide ^ 12345);<br>
+             srand( $gameSeed ^ $gameSide ^ 0xCAFE_BABE );
+         </code></td>
+       </tr>
+       <tr>
+         <td style="border-bottom: 1px dashed #f2bb13;">Other</td>
+         <td style="border-bottom: 1px dashed #f2bb13;">Unachievable until proven otherwise</td>
+       </tr>
+     </table>
+   </div>
    <div class="statement-section statement-expertrules">
      <h2>
        <span class="icon icon-expertrules">&nbsp;</span>