move module descriptions to main.py or modules themself

main.py

@@ -9,6 +9,7 @@ from traceback import format_exc as print_traceback
 sys.path += ['', '/usr/lib/python2.7', '/usr/lib/python2.7/plat-linux2', '/usr/lib/python2.7/lib-tk', '/usr/lib/python2.7/lib-old', '/usr/lib/python2.7/lib-dynload', '/usr/local/lib/python2.7/dist-packages', '/usr/lib/python2.7/dist-packages', '/usr/lib/pymodules/python2.7', '/usr/lib/pyshared/python2.7']
 
 try:
+    # Library that adds a bunch of re-usable methods which are used in nearly all other modules
     from helpers import *
 except:
     print("[RedstonerUtils] ERROR: Failed to import helpers:")
@@ -31,24 +32,43 @@ info("Loading RedstonerUtils...")
 
 # Import all modules, in this order
 shared["load_modules"] = [
+    # Collection of tiny utilities
     "misc",
+    # Adds chat for staff using /ac <text or ,<text>
     "adminchat",
+    # Adds /badge, allows to give players achievements
     "badges",
+    # Adds /calc, toggles automatic solving of Math expressions in chat
     "calc",
+    # Plugin to locate laggy chunks. /lc <n> lists chunks with more than n entities
     "lagchunks",
+    # Adds /report and /rp, Stores reports with time and location
     "reports",
+    # Adds group-chat with /chatgroup and /cgt to toggle normal chat into group mode
     "chatgroups",
+    # Adds /token, reads and writes from the database to generate pronouncable (and thus memorable) registration-tokens for the website
     "webtoken",
+    # Adds /lol, broadcasts random funyy messages. A bit like the splash text in the menu
     "saylol",
+    # Shows the owner of a skull when right-clicked
     "skullclick",
+    # Adds /listen, highlights chat and plays a sound when your name was mentioned
     "mentio",
+    # Adds /cycler, swaps the hotbar with inventory when player changes slot from right->left or left->right
     "cycle",
+    # Adds /getmotd & /setmotd to update the motd on the fly (no reboot)
     "motd",
+    # AnswerBot. Hides stupid questions from chat and tells the sender about /faq or the like
     "abot",
+    # Adds '/forcefield', creates forcefield for players who want it.
     "forcefield",
+    # Adds /damnspam, creates timeout for buttons/levers to mitigate button spam.
     "damnspam",
+    # Adds /check, useful to lookup details about a player
     "check",
+    # Adds /imout, displays fake leave/join messages
     "imout"
+    # NOTICE: If you add something here, please add a small descriptive comment above!
 ]
 shared["modules"] = {}
 for module in shared["load_modules"]:

mysqlhack.py

@@ -1,4 +1,9 @@
 #pylint: disable = F0401
+"""
+A library that makes use of the so called ClassPathHack for jython
+to allow proper loading of mysql-connector.jar at runtime.
+Import only, no methods.
+"""
 import java.lang.reflect.Method
 import java.io.File
 import java.net.URL

plotter.py

@@ -1,7 +1,9 @@
 #!/usr/bin/python
 
-# this was going to be a PlotMe-like plugin "plotter"
-# but it seems like PlotMe is still beeing developed, so we don't need our own.
+"""
+*Very basic* start of a custom plot-plugin like PlotMe
+on hold because the PlotMe developer continued to develop PlotMe
+"""
 
 import sys
 

spawnplayer.py

@@ -1,3 +1,9 @@
+"""
+Code that was used once to create this awesome screenshot
+- https://i.imgur.com/v4wg5kl.png
+- https://i.imgur.com/tIZ3jmC.png
+- https://www.reddit.com/r/Minecraft/comments/28le52/screenshot_of_all_players_that_joined_my_server/
+"""
 import net.minecraft.server.v1_7_R1.EntityPlayer as EntityPlayer
 import net.minecraft.server.v1_7_R1.PacketPlayOutNamedEntitySpawn as PacketPlayOutNamedEntitySpawn
 import net.minecraft.server.v1_7_R1.PlayerInteractManager as PlayerInteractManager

tilehelper.py

@@ -1,4 +1,7 @@
 #pylint: disable = F0401
+"""
+A plugin that automatically tiles (stacks) blocks inside a selected region in configurable directions.
+"""
 import org.bukkit.event.block.BlockPlaceEvent as BlockPlaceEvent
 import org.bukkit.event.block.BlockBreakEvent as BlockBreakEvent
 import org.bukkit.event.player.PlayerInteractEvent as PlayerInteractEvent