ShieldCore Documentation

Welcome to the official, comprehensive technical guide for ShieldCore. Our ecosystem is built from the ground up to provide seamless technical infrastructure, high-performance bot management, and simplified community protection.

What is ShieldCore?

ShieldCore is a centralized platform focused on providing clean, minimalist, and efficient tools for Discord communities. It combines a seamless Web Dashboard (PHP) with a blazing fast Node.js backend to offer realtime synchronization, auto-moderation, and channel management.

Authentication (OAuth2)

To begin using ShieldCore's interactive features, you must identify yourself via our secure Discord authentication.

Global Dashboard

Your primary command center. Here, you are presented with global platform intelligence and your personal server roster.

Live Platform Statistics

On the homepage, ShieldCore dynamically presents live usage statistics:

  • Servers & Users: Calculated directly from the Node.js bot's internal memory cache.
  • API Endpoints: Reflects the structural API size of ShieldCore's backend (dynamically calculated PHP modules).
  • Threats Blocked: An asynchronous counter that increments instantly across the Web Infrastructure whenever the Node.js bot actively deletes a malicious message or punishes a spammer.

Your Server Roster

Your dashboard evaluates your Discord permissions in real-time. Only servers where you possess the Manage Server or Administrator permission, or which you own, will appear here.

Adding/Removing the Bot: Click the plus icon to instantly invite ShieldCore to a guild via Discord's OAuth2 bot authorization page. You can remove it equally fast using the destructive trashcan icon.

Server Overview

Clicking "Manage" on any authorized server opens its dedicated management interface. The interface dynamically synchronizes state without requiring continuous, distracting page reloads.

Overview Tab

Provides a bird's eye view of the server's metrics. Note that Discord caches member counts heavily, so figures may take a few minutes to fully synchronize.

Channel Control

The channels tab provides an incredibly powerful, hierarchically organized view of your Discord Text, Voice, and Announcement channels grouped accurately by their Parent Categories.

Channel Renaming

Click the pen icon to instantly rename any channel via the Web UI.

Important limitations: Discord API strictly enforces rate limits on channel renames (max 2 renames per 10 minutes per channel). ShieldCore accurately captures these limits and will natively display an error if you attempt to exceed them.

Bulk Clear (Purge)

The broom icon allows you to completely wipe the visible history of a channel. Under the hood, ShieldCore executes a Discord Bulk Delete request, instantaneously wiping the last 100 messages to suppress massive raids without breaking structural channel layouts.

Native Channel Pausing

Unlike traditional bots that passively delete messages (which causes API lag), ShieldCore's Pause function utilizes Native Discord Permission Overwrites.

  • How it works: Clicking pause actively modifies the SEND_MESSAGES bitmask of your designated "Verified User Role" for that specific channel.
  • Zero Overhead: Messages are blocked by the Discord client directly; the bot expends no resources deleting streams of raid text.
  • State Persistence: Unpausing flawlessly restores the exact permission state that existed prior to clicking the pause button.
Prerequisite: You MUST configure a "Verified User Role" in the Settings tab before you can use the Pause feature. Furthermore, the ShieldCore bot role must be hierarchically placed above your Verify Role.

Member Management

Control your community from the web. The Members tab parses all fetched participants.

Kicks and Bans

Execute kicks and bans securely. The dashboard validates interactions dynamically; however, if the target user has a role mathematically superior to the bot, it will return an authorization failure.

Global Ban List Viewer

Review every single banned user across your server seamlessly. Bans can be managed directly via Discord client interfaces, and ShieldCore will parse the history perfectly.

Security Modules

ShieldCore offers highly granular auto-moderation systems. All logic executes blazingly fast in the Node.js memory layer, minimizing latency to milliseconds.

Intelligent URL Blocker

When enabled, ShieldCore utilizes an advanced RegEx scanner to detect heavily obfuscated links across hundreds of Top Level Domains (such as .com, .gg, .ru, .shop, etc).

  • Whitelisting: You can whitelist specific Domain names (e.g. youtube.com), entire Channels, or specific User Roles.
  • Punishment Actions: Choose between Timeout, Kick, or Ban. You can dictate the exact timeout length.
  • Notifications: Silently delete the link, or broadcast a customized warning message highlighting the offender.

Anti-Spam Firewall

An aggressive, algorithmic rate limiter designed to crush macro-based chat spammers.

Verification System

ShieldCore's Verification system is a powerful, customizable gatekeeper for your server. It ensures that only legitimate users can gain access to your community by requiring them to complete specific challenges.

Security Levels

Choose the level of friction that best suits your server's needs:

  • Basic: A simple Discord OAuth2 login. High speed, low friction.
  • Medium: OAuth2 Login + Account Age Check + Server Blocklist. Prevents "Alt" accounts and users from malicious communities.
  • Extreme: All Medium checks + a generated Math Captcha. The ultimate defense against advanced raiding scripts.

Visual Customization (Embed Editor)

Ensure the verification process feels like part of your brand. You can fully customize the message posted by the bot:

  • Embed Elements: Customize the Title, Description, and Color of the message.
  • Branding: Upload custom Footer Icons, Thumbnails, and Large Images (Banner). If left empty, ShieldCore provides professional default branding.
  • Interactive Buttons: Set a custom label for the verification button (e.g., "Join Us", "Verify Now") to match your server's style.

Advanced Protections

Protecting your server goes beyond just a button click:

  • Account Age: Reject users whose Discord accounts were created too recently (e.g., within 7 days).
  • Server Blocklist: Automatically reject users who are members of specific "raid" or "advertising" guilds.
  • Redundancy Check: The system automatically detects if a user is already verified and prevents them from re-triggering the flow unnecessarily.
Integration: The "Verified User Role" defined in your Settings is automatically used across all modules, including the Channel Pausing system. Ensure the ShieldCore Bot has a role higher than this role in your server's hierarchy.

Bot Settings

Core setup parameters for the ShieldCore instance.

Bot Identity

Rename the bot dynamically and watch it update across your Discord server in seconds. This nickname syncs systematically via a Node.js background worker.

Server Configuration

Assign the Verified User Role. This setting isolates the role that represents your primary user base, ensuring that features like Native Channel Pausing strictly clamp down on standard members without affecting Admins or Moderators.

Support System Architecture

ShieldCore's unified support portal is an interactive Web-to-Discord bridge designed to provide lightning-fast, anonymous assistance without needing complex bot commands.

Asynchronous Ticket Channels

When you click to create a ticket on the Website, the PHP backend forces the Node.js bot to generate an entirely new, isolated Text Channel on our official central Discord support server.

  • Persistent Chat: Messages typed on the Website are mapped perfectly to the Discord channel, and messages typed by Support Staff on Discord are polled back directly into your browser seamlessly.
  • State Persistence: The ticket state (and HTML rendering) is permanently preserved in your browser's localStorage, allowing you to reload or navigate away without losing your place in line.
  • Closure: Clicking "Close Ticket" deletes the physical channel on Discord cleanly.

Community Reviews & Invites

Verified Reviews

Logged-in users can write comprehensive multi-line reviews alongside a star rating. To ensure transparency, submitting a review pushes a meticulously formatted Embed directly to our public `#reviews` Discord channel. You can update or delete your review dynamically at any time.

Intelligent Dynamic Redirects

Don't use generic Discord invites. Direct your users to shieldcore.spcfy.eu/discord. ShieldCore monitors active invites locally and automatically passes traffic to the healthiest available route, eliminating expired links forever.