KillSync Bot Subscription Filters — FAQ & Recipes
What are subscription filters?
Filters let you fine-tune a KillSync subscription so it only alerts you about killmails that match your criteria. Instead of getting every kill for your target (system, corp, alliance, etc.), you can filter by ship type, ISK value, or location.
How do subscriptions and filters relate?
- Subscription = the base thing you’re tracking (e.g., an alliance, system, or region).
- Filter = extra rules that narrow down what gets sent for that subscription.
You subscribe to the Jita system. Then you add:
- Ship =
603
(Retriever) - Min ISK =
500000000
What filter types can I use?
Run /filter add
and choose one of the following types:
Filter Type | Value Format | Example |
---|---|---|
System | system_id | 30000142 (Jita) |
Region | region_id | 10000002 (The Forge) |
Ship | type_id | 603 (Retriever) |
Corporation | corp_id | 98000001 |
Alliance | alliance_id | 99000006 |
Min ISK | number | 500000000 |
Kill Type | "kill" or "loss" | kill |
How are multiple filters handled?
- Same type = OR (e.g.,
Ship=603
ORShip=606
). - Different types = AND (e.g.,
Ship=603
ANDMinISK=500m
). - If no filters are set, the subscription matches everything for its target.
How do I add/list/remove/clear filters?
Add a filter
/filter add
subscription: <pick from list>
type: Ship
value: 603
List filters on a subscription
/filter list
subscription: <pick from list>
Shows all filters attached to that subscription.
Remove a filter
/filter remove
subscription: <pick from list>
type: Ship
value: 603
Clear all filters for a subscription
/filter clear
subscription: <pick from list>
Can I add filters to an “ALL” subscription?
Yes. ALL (entity_id = 0
) supports: system
, region
, ship
, corporation
, alliance
, minISK
.
Not supported on ALL: killtype
(needs specific corp/alliance context).
Create an ALL subscription
/subscription add
entity_id: 0
#<target-channel>
min_isk: 0
Add filters to the ALL sub
Only high-value kills in Jita
/filter add
subscription: <ALL sub>
type: system
value: 30000142 # Jita
/filter add
subscription: <ALL sub>
type: minisk
value: 500000000 # 500m
More ALL examples — Region
/filter add
subscription: <ALL sub>
type: region
value: 10000002
More ALL examples — Alliance
/filter add
subscription: <ALL sub>
type: alliance
value: 99000006
More ALL examples — Ship Type
/filter add
subscription: <ALL sub>
type: ship
value: 603
- ALL embeds are neutral (white)—no kill/loss coloring.
- Combine filters: e.g.,
system=Jita
ANDminISK=500m
ANDship=603
. - Same-type filters = OR (e.g.,
ship=603
ORship=606
).
Why can’t I pick my subscription in /filter
?
- Channel-scoped: run
/filter
in the same channel as the subscription. - Guild-wide: start typing the entity name/ID to select it.
Still nothing? Make sure the subscription exists for that channel.
Quick recipes
High-value Jita feed (ALL):
/subscription add entity_id:0 #jita-kills
/filter add subscription:<ALL sub> type:system value:30000142
/filter add subscription:<ALL sub> type:minisk value:500000000
Watch one corp anywhere:
/subscription add entity_id:<corp_id> channel:#corp-kills
/filter add subscription:<corp sub> type:minisk value:100000000
Region watch with ship filter:
/subscription add entity_id:0 channel:#forge-region-kills
/filter add subscription:<ALL sub> type:region value:10000002
/filter add subscription:<ALL sub> type:ship value:603
(These won’t work by raw copy–paste; use the slash-command selector.)
Troubleshooting
- Use numeric IDs for system/region/ship/corp/alliance.
- Same-type filters = OR; different-type filters = AND.
killtype
works on corp/alliance subs; not supported on ALL.- If you moved/changed permissions, run
/filter list
to check attachment. - The filter command must be run in the channel with the subscription.