Documentation

Table of Contents

• Website
• Nomic Bot
• Propositions

Website

This website serves two main purposes:

• To be a repository of all information related to this season of BS Nomic.
• To interact with the automation system (Nomic Bot).

Nomic Bot

The Nomic Bot Discord bot is used to manage the NAS (Nomic Automation System) from the Nomic Discord server, or through Discord direct messages.

Commands

Nomic Bot commands can be executed through global/guild-specific slash commands, or by prepending the command prefix $ to the command with space-delimited arguments.

• help
  Send a list of commands that Nomic Bot supports.
  
  
• ping
  Test to see if Nomic Bot is online and get latency in ms.
  
  
• players
  Get a list of players.
  
  
• votes [message ID]
  Get the votes on a proposition.
  To get the ID of a message, ensure "Developer Mode" is on in Discord's Advanced Settings, right-click the message, and select "Copy ID".
  
  
• rand [lower bound] [upper bound]
  Generate a random integer between the lower and upper bounds (inclusive).
  If no bounds are given, this command returns a random number between 0 (inclusive) and 1 (exclusive).
  
  
• roll [XdY]
  Roll X dice of size Y.
  
  
• listrand [list]
  Randomise a given space-/comma-separated list.
  
  
• randplayer
  Return a random player.
  
  
• randplayerlist
  Return the list of players in a random order.
  
  

Propositions

All in-game propositions should be made in the #propositions channel on the Nomic Discord guild.

Syntax

When making a proposition it is always best to use a syntax the same as, or similar to, that of the other players.
This is partially for clarity and human-readability, though also because the automation system will attempt to automatically parse your propositions, and if they use invalid syntax that will cause issues.
If you don't like the syntax that other players are using, you can modify it (within reason) to suit your needs, but if you do ensure that you remain consistent.

With that said, it is preferable that you use recent propositions as a reference on how to format your proposition. If you need any more clarity, see below:

The following is the official template you should use to format your propositions:


[Modification Type] = The type of modification being made to the ruleset.
Options include:

• Addition

  Add a new rule to the ruleset.
  This requires a title and content.
  
  The recommended structure is:
  

  **Addition**
  > [Title]
  [Content]
  

  
  
• Content Edit

  Replace the content of a rule.
  This requires an ID or a title, and the complete new rule content.
  
  The recommended structure is:
  

  **Content Edit**
  > [ID or Title]
  [New Content]
  

  
  
• Title Edit

  Change the title of a rule.
  This requires an ID or old title, and the new title of the rule.
  
  The recommended structure is:
  

  **Title Edit**
  > [ID or Title]
  [New Title]
  

  
  
• Deletion

  Delete a rule.
  This requires an ID or rule title.
  
  The recommended structure is:
  

  **Deletion**
  > [ID or Title]
  

  
  
• Content Appendication

  Append more content to the end of a rule.
  This requires an ID or title and the content to append.
  
  The recommended structure is:
  

  **Content Appendication**
  > [ID or Title]
  [Additional Content]
  

  
  
• Miscellaneous Change

  Make a change to the game which has no dedicated modification type.
  This requires a description of the modification to be made to the game.
  
  The recommended structure is:
  

  **Misc Change**
  [Description of modification]
  

[ID] = The identification number of the rule you are adding/modifying/removing.
Every rule has a unique global ID which is an integer assigned to it when it is accepted into the rule tree (which makes the global ID chronological).
Note: When referring to a rule in a proposition it is advised to use both its ID and its Title.

[Title] = The title of the rule you are adding/modifying/removing.
The "title" of a rule could be more of a brief summary of the purpose of the rule.
Note: When referring to a rule in a proposition it is advised to use both its ID and its Title.

[Content] = The functional part of your rule.
For most purposes, this is the only part of your proposition that really matters.
The content of a rule needs to be easily understandable and entirely objective. Anything up to interpretation can (and will) cause loopholes or other issues, so ensure that you check your wording (and spelling) to prevent those issues from ever appearing.

The following is an example proposition using all recommended syntax: