Bukkit.org

VotifierScripts

VotifierScripts is a plugin that listens for Votifier votes and allows you to run javascript code when a vote is received (allowing for endless possibilities!) This javascript is enhanced with the power of buscript which gives access to many global functions in order to make an easy to use scripting experience. No programming experience is required, but in that case you may find this plugin harder to use than most.

This plugin requires Votifier but already comes prepackaged with buscript.

The latest development builds can always be found at http://ci.onarandombox.com/job/VotifierScripts/

Commands

Currently there's just one command

/vstest <player> [service [address [timestamp]]]
This command tests the script that is run when a vote is received.
Permission: votifierscripts.test
<player> is used to indicate a target for your script. In general, this should probably be someone that is online if you are going to use it.
The test command will always reload the vote-script.txt file so there is no need to do anything special should you modify the script.
The other 3 arguments are optional but each one requires using the one before it, so to use timestamp you have to do all 4. These will help you more fully test a vote script.

Scripts

Scripts are text files that contain Javascript code. This may sound scary to people unfamiliar with coding but luckily VotifierScripts provides several easy to use methods for creating basic scripts.

The primary script that is called when Votifier receives a vote is located at plugins/VotifierScripts/vote-script.txt. You will notice this script initially comes with a simple built in sample. Feel free to modify this!

Any script that the primary script runs must be located in plugin/VotifierScripts/scripts and may have any name/file extension you like.

Script Features

  • Easy to use global functions including command running, message broadcasting, permission management and more.
  • Any string used in these global functions has access to "%target%" which represents the current target of the script. Example: broadcast("Hello, %target%")
  • The ability to run another script at a later time with 100% reliability, even if the server crashes!
  • Defines the global variable target so more advanced things can be done with the script's target.
  • The global variable server is also available which gives direct access to the Bukkit server variable just as if you were working from within a plugin!

Detailed Script Features

Global Functions and Variables
Additional Global Functions and Variables specific to VotifierScripts

Example Scripts

Simple broadcast/command sample
vote-script.txt
  broadcast("Hey everyone, %target% is a cool guy!")
  command("op %target%")
This is a simple script that tells everyone on the server what a cool guy the target (dumptruckman in this case) is and then ops them.
Timed permission sample
vote-script.txt
  message("%target%", "You have just been given flight in the creative world for 30 minutes!")
  addPerm("creative", "%target%", "flight.permission")
  runLater("remove-perm.txt", "30m", "%target%")
scripts/remove-perm.txt:
  message("%target%", "Your flight power has been removed, hope you weren't up there!")
  removePerm("creative", "%target%", "flight.permission")
Please note these two scripts require Vault and a Vault compatible permission manager which allows them to work even when the player is not online.
It is possible to instead use the command() function to run your own permission commands without using Vault.
Also note "flight.permission" is not a real permission. Your actual flight enabling permission may vary (or not even exist!)

Click Here for more sample scripts

Click Here for script requests

For Developers

Source code: https://github.com/dumptruckman/VotifierScripts
Maven repository: http://repo.onarandombox.com/content/groups/public/
Maven pom information:

  <groupId>com.dumptruckman.minecraft</groupId>
  <artifactId>votifierscripts</artifactId>
  <version>1.0-SNAPSHOT</version>

You can add your own functionality to the scripts if you so choose. Here's how to hook into VotifierScripts:

  Plugin plugin = Bukkit.getPluginManager().getPlugin("VotifierScripts");
  if (plugin != null) {
    Buscript buscript = ((VotifierScripts) plugin).getScriptAPI();
    // Do stuff with buscript object, see documentation below
  }

For more information about the buscript library, visit: http://dev.bukkit.org/server-mods/buscript/

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of eadric9 eadric9 May 18, 2013 at 21:20 UTC - 0 likes

    @DeanosDinos69: Go

    just put in /plugins

    youtube: youtube.com/deadskymc server: 97.96.32.93 website: budercraft123.enjin.com

  • Avatar of DeanosDinos69 DeanosDinos69 May 12, 2013 at 19:26 UTC - 0 likes

    how do i run it with my server? put it intro plugins/votifier/listeners or just put it into /plugins?

  • Avatar of romeo400 romeo400 May 11, 2013 at 23:36 UTC - 0 likes

    @jwpwns: Go

    do § istead of & to add color

    @Rorro11: Go

  • Avatar of jwpwns jwpwns May 02, 2013 at 13:57 UTC - 0 likes

    How do you add color?

  • Avatar of lalabooga lalabooga Apr 30, 2013 at 13:49 UTC - 0 likes

    @Siickest: Go

    if (getVoteCount() % requiredVotes == 5) <= needs to be if (getVoteCount() % requiredVotes === 5)

  • Avatar of ryanblanksma ryanblanksma Apr 19, 2013 at 15:45 UTC - 0 likes

    Needs Update.

  • Avatar of Rorro11 Rorro11 Apr 16, 2013 at 18:37 UTC - 0 likes

    I have used this on my server now for ages and it is working like a charm still. But however, does it support color codes?

  • Avatar of Siickest Siickest Apr 05, 2013 at 13:47 UTC - 0 likes

    I'm having a problem.. My count on players doesen't seems to work.. I got this script

    var requiredVotes = 5;

function increaseVotes() {
  var voteFile = new java.io.File(plugin.getDataFolder(), "vote-counts");
  var config = org.bukkit.configuration.file.YamlConfiguration.loadConfiguration(voteFile);
  var count = config.getInt(target + ".votes");
  count++;
  config.set(target + ".votes", count);
  config.save(voteFile);
}

function getVoteCount() {
  var voteFile = new java.io.File(plugin.getDataFolder(), "vote-counts");
  var config = org.bukkit.configuration.file.YamlConfiguration.loadConfiguration(voteFile);
  return config.getInt(target + ".votes");
}

increaseVotes();
if (getVoteCount() % requiredVotes == 5) {
  command("/eco give %target% 500")
  command("/give %target% 264 3")
  broadcast("&7>> &d%target%&6 Thanks for voting to make the server number 1. Here is your &a500$&6 and your &bdiamonds.                    You can also vote by typing /vote")
  // etc... just copy and paste commands
}

    When I have voted 5 times even 7.. I do not give any reward either do my friend :O Why?

  • Avatar of sephkurai sephkurai Apr 05, 2013 at 00:54 UTC - 0 likes

    @thedestinycrew1: Go

    try changing the port votifier uses

  • Avatar of Creppii Creppii Apr 01, 2013 at 09:22 UTC - 0 likes

    Hay I've 2 Problems: 1. I don't see the vote-script.txt in the folder... and if i try to upload this, it doesn't show too 2. I Can't delete the folder "VotifierScripts"

Table of contents

  1. 1 Commands
  2. 2 Scripts
    1. 2.1 Script Features
    2. 2.2 Detailed Script Features
    3. 2.3 Example Scripts
    4. 2.4 Click Here for more sample scripts
    5. 2.5 Click Here for script requests
  3. 3 For Developers

Facts

Date created
Jul 23, 2012
Categories
Last update
Aug 22, 2012
Development stage
Release
Language
  • enUS
License
Mozilla Public License 2.0
Curse link
VotifierScripts
Downloads
9,168
Recent files

Authors