RedstonerUtils

Redstoner's custom plugins, written in python.

Installation / Set-up

1-line-install-script for bash: wget -O install.sh "http://pastie.org/pastes/9310905/download?key=6byp4mrqmiui8yqeo3s6yw"; md5sum --check <<<"3499671c0832e561bc9c7d476d2167cb install.sh" && sh install.sh

Detailed description:

0. Create a new directory called 'redstoner'
1. Download the latest spigot
2. Run it once inside redstoner, then shut it down again
3. Create a new directory (inside redstoner) called 'lib'
4. Download jython and save it as 'jython.jar' inside lib
5. Download mysql-connector, extract 'mysql-connector-java-X.X.XX-bin.jar ' and save it as 'mysql-connector.jar' inside lib
6. Download PyPluginLoader (we're using this fork) into the plugins directory
7. inside plugins, clone this directory into 'redstoner-utils**.py.dir**':
   git clone git@bitbucket.org:redstonesheep/redstoner-utils.git redstoner-utils.py.dir
8. Download PEX into plugins
9. if you want to develop mysql things, set up a local MySQL server

branches

• dev Always use this branch to change code, please test before pushing. (If something goes wrong here, that's okay)

• master Never commit into this branch directly! Only merge stable versions of dev:

  git checkout master
  git merge dev
  

Deploying on the server

Never edit the files directly on the server! The dev server uses the dev branch, the live server uses master.

Please use the script <server-dir>/git_pull_utils.sh. Do not use git pull on the server! All files must be owned and pulled by the redstoner user.

Be very careful with the live server! Make sure you're in the master branch and the code is working before pulling/restarting!

Modules / Files

If you add a new file, please update this list!

If you want the server to load a file (module) on startup, add it to the modules list in main.py.

• files/

  All config / storage files go here

• plugin.yml

  The plugin.yml file required for bukkut plugins

• main.py

  The only file loaded by PyPluginLoader, loads all other modules
  Contains a few methods that need to be cleaned up

• helpers.py

  Library that adds a bunch of re-usable methods which are used in nearly all other modules

• adminchat.py

  Adds chat for staff using /ac <text or ,<text>

• chatgroups.py

  Adds group-chat with /chatgroup and /cgt to toggle normal chat into group mode

• lagchunks.py

  Plugin to locate laggy chunks. /lc <n> lists chunks with more than n entities

• mysqlhack.py

  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.

• plotter.py

  Start of a custom plot-plugin like PlotMe, on hold because the PlotMe developer continued to develop PlotMe

• reports.py

  The /report <text> and /rp plugin

• saylol.py

  Remake of sheep's old SayLol plugin, originally written as a standalone plugin in Java

• skullclick.py

  Shows the owner of a skull when right-clicked

• webtoken.py

  Adds /token, reads and writes from the database to generate pronouncable (and thus memorable) registration-tokens for the website

• spawnplayer.py

  Code that was used once to create this awesome screenshot

• tilehelper.py

  A plugin that automatically tiles (stacks) blocks inside a selected region in configurable directions.

• mentio.py

  Adds /listen, highlights chat and plays a sound when your name was mentioned

• cycler.py

  Adds /cycler, swaps the hotbar with inventory when player changes slot from right->left or left->right

• motd.py

  Adds /getmotd & /setmotd to update the motd on the fly (no reboot).

• abot.py

  AnswerBot. Hides stupid questions from chat and tells the sender about /faq or the like

• damnspam.py

  Adds /damnspam, creates timeout for buttons/levers to mitigate button spam.

Code styleguide & tips

Indentation

Never use tabs! Use 2 spaces to indent.

Quotes

Always use double-quotes! Only use single-quotes when the string contains double-quotes that would need to be escaped.

Comments

Comments are good! Please comment everything that's non-obious or makes it easier to understand

Debugging

Debugging can be a bit special with jython/PyPluginLoader.

When something goes wrong, you probably see a weird traceback that's not telling you shit. ...unless you take a closer look.

You will not see a direct traceback of the python methods. Instead, you'll probably see a bunch of java, bukkit and python things, because it tries to translate python into java, line per line. Take a closer look at the method names, they might tell you what it's trying to do and where it's coming from.

Watch out for something like org.python.pycode._pyx5.horribleCode$23(/path/to/badcode.py:214) ~[?:?] 0. In this case, _pyx5 is our module. 0. horribleCode is the method that was called 0. /path/to/badcode.py is the actual file of our module 0. :214 is the line in which the error occured.

Please note that the line may not be accurate. You'll often get the start or end of a loop, method, or the like - when the actual error was somewhere in there.

In many cases, this is enough to find your bug. If you still cannot find it,try to catch exceptions in your code, as follows:

Catching exceptions

If you want to catch all exceptions (e.g. for debugging), do not:

try:
  # code
except Exception, e:
  print(e)

Since we're using jython, this will not catch Java exceptions. This will give you some more deatails:

import traceback
try:
  #code
except: # everything
  print(traceback.format_exc())