Difference between revisions of "Migration Guide"

Revision as of 18:37, 13 March 2006

This guide will highlight some of the known pitfalls and gotchas when moving from subgame to asss.

You may need to familiarise yourself with modules.conf to apply some of the fixes.

Settings

Team:MaxFrequency

This setting now behaves as it is written. It is the maximum frequency you can enter. It is not the maximum number of frequencies available. For example setting this to 5 means you can enter 0,1,2,3,4,5.

Prize:MinimumVirtual or Why do my flags and balls spawn differently?

Flags and balls now have their own spawn settings:

SpawnX = 512
SpawnY = 512
SpawnRadius = 20

Additionally balls can have multiple spawns as of version 1.4.2:

SpawnXN = 512
SpawnYN = 512
SpawnRadiusN = 20

Where N is 0,1,2,3. The numbers correspond to the ball ID. For example if you have 2 balls the ID's will start from 0. Ball 0 will use Spawn...0 and ball 1 will use Spawn...1. You can have up to 8 balls, meaning ball 4 will use Spawn...0 and so on.

Commands

Why doesn't ?owner work anymore?

This is disabled by default. You need to add the line 'cmd_owner' to conf/groupdef.dir/default.

Why doesn't ?objon work anymore?

The objects module is not loaded by default. You need to add the line 'objects' to conf/modules.conf.

Why doesn't *arena <msg> work anymore?

The command has been shortened to ?a <msg>. Additionally ?aa <msg> will anonymise the originator; their name will not be automatically appended to the message.

You can use the sgcompat module to restore this command.

Why doesn't *log work anymore?

This has been replaced with ?lastlog [<number of lines>] [<filter text>] where [] means an optional parameter.

You can use the sgcompat module to alias this command to *log, however the format will not change back to subgame format.

Why doesn't ?help <msg> work anymore?

For an unknown reason the creator of asss decided to use this command as an online manual for commands and settings. Possibly because many billers used a similar ?man command.

There is currently no workaround.

Can I add more AlertCommands like ?cheater ?

You cannot do this with vanilla asss. However you can write a custom module to handle these. See Writing Modules In Python for more information.

Game quirks

I have some LVZ objects controlled by a bot but they don't work anymore

The objects module is not loaded by default. You need to add the line 'objects' to conf/modules.conf.

Why am I not seeing a greet message when I enter the arena? or Where have the periodic messages gone?

The messages module is not loaded by default. You need to add the line 'messages' to conf/modules.conf.

Additionally the PeriodicMessageN settings are bugged in asss. You can download a patch for 1.4.2 from http://toktok.sscentral.com/dump/messages.c.patch.txt.

What's up with the goal message?

If you are seeing 'SCORE: Warbirds:xx Javelins:xx' and would rather see Team0,Team1 then read on.

The points_goal module was coded for a specific purpose and did not implement all the things from subgame. You can download a patch from http://toktok.sscentral.com/dump/points_goal.c-scoremsg.patch.txt.

I want to keep my bots but they aren't behaving, is there any hope?

There is a module called sgcompat that creates command aliases from subgame commands to asss commands. To use the module add 'funky:sgcompat' to conf/modules.conf.