These docs are for v4.3.22. Click to read the latest docs for v4.4.0.

Hello, World!

This guide will show you how to get up and running with plugin development as fast as possible.

Introduction

Requirements:

  • You must have the .NET framework 4.5 installed
  • You must have a copy of TerrariaServer.exe, TShockAPI.dll, and OTAPI.dll.
  • You must have some IDE installed, eg Visual Studio.

Creating a skeleton project

Open Visual Studio, or your IDE of choice. Create a project, using a class library as the base, and naming it something sensible.

941

Next, refactor Class1.cs into something logical as well. Insert the following skeleton code:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using TShockAPI;
using Terraria;
using TerrariaApi.Server;
 
namespace TestPlugin
{
    [ApiVersion(2, 0)]
    public class TestPlugin : TerrariaPlugin
    {
      	/// <summary>
      	/// Gets the author(s) of this plugin
        /// </summary>
      	public override string Author 
        {
          	get { return "Anonymous"; }
        }
      	
      	/// <summary>
      	/// Gets the description of this plugin.
        /// A short, one lined description that tells people what your plugin does.
      	/// </summary>
      	public override string Description 
        {
          	get { return "A sample test plugin"; }
        }
      
      	/// <summary>
        /// Gets the name of this plugin.
        /// </summary>
      	public override string Name 
        {
          	get { return "Test Plugin"; }
        }
      
        /// <summary>
        /// Gets the version of this plugin.
        /// </summary>
      	public override Version Version
        {
          	get { return new Version(1, 0, 0, 0); }
        }
      
        /// <summary>
        /// Initializes a new instance of the TestPlugin class.
        /// This is where you set the plugin's order and perfrom other constructor logic
        /// </summary>
      	public TestPlugin(Main game) : base(game)
        {
          	
        }
        
        /// <summary>
        /// Handles plugin initialization. 
        /// Fired when the server is started and the plugin is being loaded.
        /// You may register hooks, perform loading procedures etc here.
        /// </summary>
        public override void Initialize()
        {
          	
        }
      
        /// <summary>
        /// Handles plugin disposal logic.
        /// *Supposed* to fire when the server shuts down.
        /// You should deregister hooks and free all resources here.
        /// </summary>
        protected override void Dispose(bool disposing)
        {
          	if (disposing)
            {
              	// Deregister hooks here
            }
          	base.Dispose(disposing);
        }
    }
}

Essentials to remember are:

  • You must extend TerrariaPlugin
  • You must have a name, author, description, and plugin version
  • You must support the same version of the API that you're developing for

Don't forget to reference!

Now that you have some code, Visual Studio will be yelling at you because it has no idea where to look for the code. Add references appropriately, and your code should be error free and compile fine.

786

When completed, your references should look something like this:

349

Testing your plugin

At this point, you should be able to tap F6 and your code will compile without error. Assuming you're compiling in debug mode, your dll will be in the bin/debug/ directory in the same directory that your solution resides. Drop this in the ServerPlugins folder, run the server, and you should see your plugin loading at the top.

979