n8n-nodes-discord-dnd 0.1.115 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +154 -0
  2. package/package.json +10 -4
package/README.md ADDED
@@ -0,0 +1,154 @@
1
+ # n8n-nodes-discord-dnd
2
+
3
+ [![npm version](https://badge.fury.io/js/n8n-nodes-discord-dnd.svg)](https://www.npmjs.com/package/n8n-nodes-discord-dnd)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+
6
+ This is an n8n community node package that provides nodes to interact with the Discord API via a Discord bot, allowing you to automate Discord workflows.
7
+
8
+ ![Discord Nodes Overview](https://raw.githubusercontent.com/nguyendanhda98/n8n-nodes-discord-dnd/main/docs/images/discord-nodes-overview.png)
9
+
10
+ ## Features
11
+
12
+ This package provides two nodes:
13
+ - **Discord Trigger DND**: Triggers workflows based on Discord events
14
+ - **Discord Action DND**: Performs actions in Discord channels and conversations
15
+
16
+ ## Discord Trigger Node
17
+
18
+ The Discord Trigger node allows you to start n8n workflows when specific Discord events occur. It supports a wide range of trigger types:
19
+
20
+ ### Trigger Types
21
+ - **Message**: Listen for message-related events like message creation, deletion, updates, and reactions
22
+ - **Guild**: Events related to servers, channels, and threads
23
+ - **Moderation**: Ban events and audit log entries
24
+ - **Emoji & Sticker**: Track emoji and sticker changes in a server
25
+ - **Integration & Webhook**: Monitor integration and webhook updates
26
+ - **Invite**: Track creation and deletion of invites
27
+ - **Voice**: Monitor voice channel activities
28
+ - **Presence**: Track user presence status changes
29
+ - **Scheduled Event**: Listen for scheduled events in servers
30
+ - **Interaction**: Handle interactions like slash commands
31
+ - **Bot Status**: Get bot-related events like ready status
32
+ - **User**: User updates and guild member events
33
+ - **Auto Moderation**: Auto-moderation rule events
34
+ - **Poll**: Discord poll events
35
+
36
+ ### Message Filtering
37
+ For message triggers, you can filter based on:
38
+ - Bot mentions
39
+ - Message content (contains, starts with, ends with, equals, regex)
40
+ - Direct messages
41
+ - Server, channel, role, and user filters
42
+
43
+ ## Discord Action Node
44
+
45
+ The Discord Action node allows you to perform actions in Discord:
46
+
47
+ ### Message Actions
48
+ - Send typing indicator
49
+ - Send messages (with text, embeds, and files)
50
+ - Delete messages
51
+ - Edit messages
52
+ - React to messages
53
+ - Remove reactions
54
+ - Pin/unpin messages
55
+
56
+ ## Installation
57
+
58
+ ### npm
59
+ ```bash
60
+ npm install n8n-nodes-discord-dnd
61
+ ```
62
+
63
+ ### n8n
64
+ In your n8n installation:
65
+ 1. Go to **Settings > Community Nodes**
66
+ 2. Click **Install a node**
67
+ 3. Enter `n8n-nodes-discord-dnd` and click **Install**
68
+
69
+ ## Setup
70
+
71
+ 1. Create a Discord bot on the [Discord Developer Portal](https://discord.com/developers/applications)
72
+ 2. Create a new Discord API DND credential in n8n
73
+ 3. Enter your Bot Token and Application ID
74
+ 4. Enable necessary Privileged Intents for your bot (Message Content)
75
+ 5. Invite the bot to your server with appropriate permissions
76
+
77
+ ## Screenshots
78
+
79
+ ### Discord Trigger Node Configuration
80
+ ![Discord Trigger Node](https://raw.githubusercontent.com/nguyendanhda98/n8n-nodes-discord-dnd/main/docs/images/discord-trigger-node.png)
81
+
82
+ ### Discord Action Node Configuration
83
+ ![Discord Action Node](https://raw.githubusercontent.com/nguyendanhda98/n8n-nodes-discord-dnd/main/docs/images/discord-action-node.png)
84
+
85
+ ## Usage Examples
86
+
87
+ ### Creating a Discord Bot that Responds to Messages
88
+
89
+ 1. Add a **Discord Trigger DND** node
90
+ 2. Set trigger type to "Message"
91
+ 3. Set event to "Message Create"
92
+ 4. Configure pattern (e.g., "Bot Mention" or "Starts With" with a command prefix)
93
+ 5. Connect to a **Discord Action DND** node
94
+ 6. Set action type to "Message"
95
+ 7. Set action to "Send Message"
96
+ 8. Configure the message content
97
+
98
+ ### Logging Channel Changes
99
+
100
+ 1. Add a **Discord Trigger DND** node
101
+ 2. Set trigger type to "Guild"
102
+ 3. Set event to "Channel Update"
103
+ 4. Connect to nodes that process and store the channel update data
104
+
105
+ ## License
106
+
107
+ [MIT](LICENSE)
108
+
109
+ ## Contributors
110
+
111
+ - [NguyenDanhDa](https://github.com/nguyendanhda98)
112
+
113
+ ## Repository
114
+
115
+ Source code: [https://github.com/nguyendanhda98/n8n-nodes-discord-dnd](https://github.com/nguyendanhda98/n8n-nodes-discord-dnd)
116
+
117
+ ## Troubleshooting
118
+
119
+ ### Common Issues
120
+
121
+ 1. **Bot not responding to messages**
122
+ - Make sure you've enabled the "Message Content Intent" in the Discord Developer Portal
123
+ - Verify the bot has proper permissions in the Discord server
124
+ - Check if the pattern configuration matches your message format
125
+
126
+ 2. **Missing events**
127
+ - Some events require specific intents to be enabled on your bot
128
+ - Make sure the bot has the necessary permissions in the server
129
+
130
+ 3. **Authentication errors**
131
+ - Verify your Bot Token and Application ID are correct
132
+ - Make sure your bot hasn't been reset or regenerated in the Discord Developer Portal
133
+
134
+ ### Support
135
+
136
+ If you encounter any issues not covered here, please [create an issue](https://github.com/nguyendanhda98/n8n-nodes-discord-dnd/issues) on GitHub.
137
+
138
+ ## Contributing
139
+
140
+ If you want to contribute, please fork the repository and submit a pull request.
141
+
142
+ 1. Fork the repository
143
+ 2. Create a new branch (`git checkout -b feature/your-feature`)
144
+ 3. Commit your changes (`git commit -m 'Add some feature'`)
145
+ 4. Push to the branch (`git push origin feature/your-feature`)
146
+ 5. Create a new Pull Request
147
+
148
+ ## Changelog
149
+
150
+ ### 0.1.115
151
+ - Initial public release
152
+ - Added Discord Trigger node with multiple event types
153
+ - Added Discord Action node with message actions
154
+ - Setup documentation and repository information
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "n8n-nodes-discord-dnd",
3
- "version": "0.1.115",
3
+ "version": "1.0.0",
4
4
  "description": "n8n node to create triggers for Discord events",
5
5
  "keywords": [
6
6
  "n8n",
@@ -9,12 +9,18 @@
9
9
  "discord",
10
10
  "trigger",
11
11
  "webhook"
12
- ],
13
- "author": {
12
+ ], "author": {
14
13
  "name": "NguyenDanhDa"
15
14
  },
16
15
  "license": "MIT",
17
- "main": "index.js",
16
+ "main": "index.js", "repository": {
17
+ "type": "git",
18
+ "url": "git+https://github.com/nguyendanhda98/n8n-nodes-discord-dnd.git"
19
+ },
20
+ "homepage": "https://github.com/nguyendanhda98/n8n-nodes-discord-dnd#readme",
21
+ "bugs": {
22
+ "url": "https://github.com/nguyendanhda98/n8n-nodes-discord-dnd/issues"
23
+ },
18
24
  "scripts": {
19
25
  "dev": "npm run watch",
20
26
  "build": "tsc && gulp build:icons",