Create a Stendhal server extension

From Arianne
Jump to navigation Jump to search


How to create a server extension? This will teach you how to! Todays project: add the commands "/date" and "/time" for the users, so that they can check what time or what date it is.

Requirements

Whats required?

  • An OS
  • Text editor
  • Java
  • A ready stendhal server
  • Java knowledge is recommened

Getting your own setup

Ok, let's be cliched here. The "hello, world!" of stendhal server extensions!

The file

Create a file in <downloaded stendhal source>/src/games/stendhal/server/extension/ called "HelloWorldExtension.java" and add this to it (just for now):

package games.stendhal.server.extension;

import games.stendhal.server.StendhalRPAction;
import games.stendhal.server.StendhalRPRuleProcessor;
import games.stendhal.server.StendhalRPWorld;
import games.stendhal.server.StendhalRPZone;
import games.stendhal.server.StendhalServerExtension;
import games.stendhal.server.entity.Player;
import marauroa.common.Log4J;
import marauroa.common.game.RPAction;
import marauroa.server.game.RPWorld;

import org.apache.log4j.Logger;

public class HelloWorldExtension extends StendhalServerExtension {

    private final String HELLOWORLD = "helloworld";
    private static final Logger logger = Log4J.getLogger(HelloWorldExtension.class);
    
    /**
     * @param rules - the reference to the rules processor
     * @param world - the reference to the game objects
     */
    public HelloWorldExtension(StendhalRPRuleProcessor rules, StendhalRPWorld world) {
        super(rules, world);
        logger.info("HelloWorldExtension starting...");
        StendhalRPRuleProcessor.register("hello", this);
    }

    /* 
     * @see games.stendhal.server.StendhalServerExtension#init()
     */
    @Override
    public void init() {
        // this extension has no spespecific init code, everything is
        // implemented as /commands that are handled onAction
    }
    
    @Override
    public void onAction(RPWorld world, StendhalRPRuleProcessor rules,
            Player player, RPAction action) {
       String type = action.get("type");
        
        if (type.equals("hello")) {
            onHello(world, rules, player, action);
        }
     
    }
    
    private void onHello(RPWorld world, StendhalRPRuleProcessor rules, Player player, RPAction action) {
    	player.sendPrivateText("Hello, world!");
    }
}

Time for an explanation: First, we import a whole lot of stuff. This is just so we can interact with every aspect of the server & game world. Next, we define our class and initilazation function. In that, we request for some variables, and startup the logger. This line:

private static final Logger logger = Log4J.getLogger(HelloWorldExtension.class);

creates a logger and configures it for the current class.

StendhalRPRuleProcessor.register("hello", this);

This code tells the server "register the command '/hello' to this class" ('this' is a dynamic variable that points the class). Nice, huh? Now the user can type '/hello' into their textboxes without getting a not found error! Wheeee! Now, lets continue onto the onAction functio. In it, we check to see if the command is hello, and run the onHello function. In the onHello world function, we then send the player, who ran the command, a private message: Hello, world! Pretty boring, huh? Now, onto the main project!

Date and Time

Now, I'm not going to re-post the entire script, as it gets to be just under 100 lines of code, and I don't want a INCREDIBLY long page! First, we import a new class: java.util.Calendar With that, we can get the current date and time! Then, add these lines to your class method:

StendhalRPRuleProcessor.register("date", this);
StendhalRPRuleProcessor.register("time", this);

These register the date and time commands. Now, we add the if to onAction:

        if (type.equals("date")) {
            onDate(world, rules, player, action);
        } else if (type.equals("time")) {
            onTime(world, rules, player, action);
        }

And add the two functions onDate and onTime:

    private void onDate(RPWorld world, StendhalRPRuleProcessor rules,
			Player player, RPAction action) {
		Calendar calendar = Calendar.getInstance();
		String[] months = {"Jan", "Feb", "Mar", "Apr", "May", "Jun", "July", "Aug", "Sep", "Oct", "Nov", "Dec"};
		player.sendPrivateText("The current date is: " + months[calendar.get(calendar.MONTH)] + ", " + calendar.get(calendar.DATE) + ", " + calendar.get(calendar.YEAR));
	}
	
    private void onTime(RPWorld world, StendhalRPRuleProcessor rules,
			Player player, RPAction action) {
		Calendar calendar = Calendar.getInstance();
		player.sendPrivateText("The current time is: " + calendar.getTime().toString());
	}

That's it! Now, just recompile your server, and boom! Your 75% there! Now, one last thing; configuring the server to load your new extension.

Configuration

Now open the file server server.ini, and add these lines:

date_time=games.stendhal.server.extension.DateAndTimeExtension
server_extension=date_time

Now, if you've been following the tut, don't just copy/paste the second line - add 'date_time' to the end of the list, with a comma before it. Also, if you've saved the file somewhere else (which I don't recommend doing, it's in a folder called "extension") you're going to have to change the class path to point to that.

Done

Done! Now you've completely added 2 extensions, one of which is pointless other than, "I did it! I did it!" Have your users be notified of the change; they may or may not like it!