This post is about the init function in golang and how it can be used for package initialization, avoiding filling the main function with initialization for each packet.


The necessity to initialize a packet before main function comes when trying to reduce the number of queries to zworld’s items database.

This (file based) database contains the information for all the items in the game, so it is easier to check, update and share the information t both the client and server.

When implementing chicken nest block’s interaction, we had to:

  • check if it was really that block
  • change it to the empty version (without eggs)
  • give the player the eggs collected

That means on every nest interaction, three queries will be performed.

It seems like it is just a few. But the current implementation of the find item from id name (“chicken_nest_eggs”, …) is O(n) in the number of items, checking id by id comparing strings, so probably worse. This means a very bad performance when the items database grows.

Proposed Solution

We couldn’t just create some globals, as the package initialization was being done in the main function, resulting in nil data when initializing the globals.

This is when Go’s init function comes handy. This function allows you to run code the first time the package is initialized. The order of this initialization is in import order, following recursively imports first. And, after all, the main function will be executed.

By initializing the items database package on the init function, we can allow any package importing the items database package to initialize globals, as the database will be already initialized.


Golang’s init function is a very handy (and unique, as most languages don’t have it) function and not so widely known.

It can ensure certain behavior happens whatever the user does with the package, but leaves him with no control about errors on initialization or execution order.