3
0
mirror of https://github.com/jlu5/PyLink.git synced 2024-12-24 19:52:53 +01:00

docs: Add services config guide and mention matching config<->register

This commit is contained in:
Ken Spencer 2017-03-13 11:35:32 -04:00
parent a6e38e7e20
commit 9a3ef0122b

View File

@ -0,0 +1,67 @@
# Advanced Service Config
There are some service configuration options that you may want to be aware of.
**NOTE**: Your SERVICE name in the `utils.registerService("SERVICE", desc=desc)`
call and the service configuration in 'SERVICE::' **MUST** match for these
directives to apply.
#### Nick / Ident
In addition to setting a per-server 'nick' or 'ident' using,
```yaml
servers:
somenet:
# ...
SERVICE_nick: OTHERNICK
SERVICE_ident: OTHERIDENT
```
You can also just set an arbitrary nick/ident using a per-**service** directive.
```yaml
SERVICE:
nick: OTHERNICK
ident: OTHERIDENT
```
#### JoinModes
When joining a channel, ServiceBot Instances will just join and sit there.
However, you can set a mode that the bot will ask for when it joins any channel.
```yaml
SERVICE:
joinmodes: 'o'
```
This would request the mode 'o' (usually op on most IRCds) when joining the channel.
Technically any mode can be put here, but if an IRCd in question doesn't support
the mode then it just ignores it.
You can also use combinations of modes, such as 'ao' (usually admin/protect + op)
```yaml
SERVICE:
joinmodes: 'ao'
```
Combinations should work provided an IRCd in question supports it.
#### Prefix
You can also set the Service Bots fantasy prefix, of course this is only
applicable if the 'fantasy' plugin is loaded.
The setting allows for one or more characters to be set as the prefix.
```yaml
SERVICE:
prefix: './'
```
This is perfectly valid, as is any other string.