Skip to Content
Haven Documentation is the shared home for product guides, plugin setup, and release docs.

Social Actions Setup

Requirements

  • AthenaBot with the core plugin enabled
  • Permission for the bot to view the channel, send messages, and embed links
  • Outbound HTTPS access to https://nekos.best
  • Enough room under Discord’s 100 global application-command limit for 23 commands

Nekos.best does not require an API key.

Install

  1. Extract the release and place the social_actions folder in AthenaBot’s plugins directory.
  2. Keep the folder name as social_actions.
  3. Start or restart AthenaBot.
  4. Check the startup log for Successfully loaded plugin social_actions.
  5. Confirm AthenaBot registers the global slash commands without exceeding Discord’s command limit.

AthenaBot creates these files from the included templates:

configuration/social_actions.json5 configuration/social_actions-lang.json5

Test the Plugin

  1. Open a private test channel.
  2. Run /hug and select another member in the user option.
  3. Confirm the response includes the action text, counter, and GIF.
  4. Confirm the target receives a notification while ping_target_user is true.
  5. Ask the target to test both Interact Back and Reject.

Only the targeted member can use the response buttons.

Upgrade from v1.0.1

  1. Back up the existing plugin folder and both Social Actions config files.
  2. Replace the plugin folder with v1.0.2.
  3. Add ping_target_user to configuration/social_actions.json5 if AthenaBot does not merge the new default into your existing file.
  4. Restart AthenaBot.
{ config: { ping_target_user: true, }, }