Skip to main content
Modrinth is an open-source platform built for the Minecraft community. Whether you’re a player looking for mods, a creator sharing content, or hosting servers, Modrinth provides powerful tools for everyone.

​
Search and Discovery

Modrinth’s search engine is designed for speed and precision:

Real-Time Results

  • Instant search results as you type
  • Sub-100ms response times
  • Fuzzy matching for typos
  • Relevance-based ranking

Advanced Filtering

  • Game version compatibility
  • Mod loader support (Fabric, Forge, Quilt, NeoForge)
  • Categories and tags
  • Client/server side filtering
  • Open source projects filter

​
Sorting Options

Find projects sorted by:
  • Relevance - Best matches for your search
  • Downloads - Most popular projects
  • Follows - Most followed by community
  • Updated - Recently updated projects
  • Newest - Latest additions to Modrinth

​
Category System

Browse projects by category:
  • Technology - Tech mods and automation
  • Adventure - Exploration and questing
  • Magic - Spells and enchantments
  • Decoration - Building and aesthetics
  • Library - APIs and frameworks
  • Optimization - Performance improvements
  • Utility - Tools and helpers
  • And many more…

​
Project Types

Gameplay modifications that add features, mechanics, or content:
  • Client-side mods (visual enhancements, UI improvements)
  • Server-side mods (gameplay mechanics, admin tools)
  • Universal mods (work on both client and server)
Supported Loaders: Fabric, Forge, Quilt, NeoForge

​
Discovery Features

Homepage Showcase
  • Featured projects carousel
  • Trending projects this week
  • New and updated projects
  • Random project discovery
Collections
  • User-curated project lists
  • Themed collections
  • Modpack recommendations
  • Creator picks
Following System
  • Follow favorite projects
  • Receive update notifications
  • Track new versions
  • Get release announcements
When you follow a project, you’ll receive notifications about new versions, including changelog information and compatible game versions.

​
Team Collaboration

Modrinth supports full team collaboration for projects with granular permission management.

​
Team Management

Invite Members

  • Invite by Modrinth username
  • Set custom role titles
  • Configure permissions per member
  • Pending invitation system
  • Team member profiles

Permission System

  • Upload version
  • Delete version
  • Edit project details
  • Manage team invites
  • Remove members
  • Edit member permissions
  • Delete project
  • View analytics
  • View revenue

​
Monetization Split

Configure revenue sharing between team members:
  • Set monetization weight per member
  • Automatic revenue distribution
  • Transparent earnings tracking
  • Proportional split calculations
  • Individual payout management
Example: If Member A has weight 2 and Member B has weight 1, Member A receives 66.7% of revenue while Member B receives 33.3%.

​
Collaboration Features

Version Management
  • Multiple team members can upload versions
  • Version approval workflow (optional)
  • Rollback capabilities
  • Beta version channels
Content Editing
  • Collaborative description editing
  • Gallery management
  • Link updates
  • Metadata changes
Team Communication
  • Internal notes
  • Version changelogs
  • Project announcements

​
Analytics for Creators

Comprehensive analytics dashboard for tracking project performance.

​
Download Analytics

  • Total downloads across all projects
  • Downloads by project
  • Downloads by version
  • Growth trends over time
  • Comparative project performance

​
Engagement Metrics

Page Views
  • Project page views
  • Version page views
  • Gallery views
  • Referral sources
  • Search result impressions
Community Engagement
  • Follower count growth
  • Comments and discussions
  • Star ratings and reviews
  • Social shares

​
Revenue Analytics

For monetized projects:
  • Ad Revenue - Earnings from project page ads
  • Payout History - Track payment distributions
  • Revenue Trends - Historical earnings data
  • Team Split - Per-member earnings breakdown
  • Withdrawal Status - Available balance and pending payouts
Revenue analytics are available per-project and aggregated across all your projects. Access them at /dashboard/analytics.

​
Data Export

Export your analytics data:
  • CSV format for spreadsheets
  • JSON format for custom analysis
  • Custom date ranges
  • Filtered by project
  • Historical data retention

​
Server Hosting

Modrinth Servers is currently in beta. Learn more about hosting

​
Managed Minecraft Servers

Modrinth provides managed Minecraft server hosting with deep platform integration:

One-Click Setup

  • Choose server plan and region
  • Select Minecraft version and mods
  • Automatic mod installation
  • Pre-configured for performance
  • Launch in minutes

Modrinth Integration

  • Browse and install mods from dashboard
  • One-click modpack deployment
  • Automatic dependency resolution
  • Update mods from control panel
  • Server-compatible mod filtering

​
Server Features

Management Panel
  • Start/stop/restart server
  • Real-time console access
  • File manager with FTP access
  • Scheduled restarts and backups
  • Player management tools
Performance
  • High-performance NVMe storage
  • DDoS protection included
  • Multiple data center regions
  • Low-latency networking
  • Automatic performance optimization
Mod Management
  • Install mods directly from Modrinth
  • Automatic updates for installed mods
  • Version compatibility checking
  • Plugin support for Bukkit/Spigot/Paper
  • Resource pack hosting

​
Regions and Availability

Choose from multiple server locations:
  • North America (East and West Coast)
  • Europe (Multiple locations)
  • Asia-Pacific
  • South America
Features by Region
  • Low-latency connections
  • Redundant infrastructure
  • Regional compliance
  • 24/7 monitoring

​
Pricing Plans

Flexible server plans:
  • Starter - Small servers for friends
  • Community - Medium-sized communities
  • Large - Big servers and networks
  • Custom - Enterprise solutions
Payment Options
  • Credit/debit cards via Stripe
  • PayPal
  • Multiple currencies supported
  • Monthly or annual billing
  • Prorated upgrades/downgrades

​
API Access

Modrinth provides a comprehensive REST API for developers.

​
API Features

Open and Free

  • No authentication required for read operations
  • Rate limiting: 300 requests per minute
  • Open source API client libraries
  • GraphQL support (coming soon)

Comprehensive

  • Search projects
  • Get project details
  • List versions
  • Download files
  • User authentication
  • Project management

​
API Endpoints

Public Endpoints (No auth required) 
GET /v2/search
GET /v2/project/{id}
GET /v2/project/{id}/version
GET /v2/version/{id}
GET /v2/user/{id}
GET /v2/tag/category
GET /v2/tag/loader
Authenticated Endpoints (Requires API token) 
POST /v2/project
PATCH /v2/project/{id}
POST /v2/version
POST /v2/version/{id}/file
GET /v2/analytics

​
Rate Limiting

  • Unauthenticated: 300 requests/minute per IP
  • Authenticated: 1000 requests/minute per token
  • Burst: Up to 50 requests at once
  • File downloads: Unlimited (CDN served)

​
Client Libraries

Official and community libraries:
  • JavaScript/TypeScript - @modrinth/api-client
  • Python - modrinth
  • Rust - ferinth
  • Java - modrinth4j
  • Go - go-modrinth
Example Usage (TypeScript) 
import { ModrinthClient } from '@modrinth/api-client'

const client = new ModrinthClient()
const results = await client.labrinth.search.search({
  query: 'optimization',
  facets: [['categories:optimization']],
})

​
Webhooks

Receive real-time notifications:
  • New version uploads
  • Project updates
  • Comment notifications
  • Analytics milestones
Configure webhooks in project settings.

​
Content Guidelines

​
Allowed Content

Modrinth welcomes:
  • Mods, plugins, and resource packs
  • Modpacks and data packs
  • Shaders and optimization mods
  • Libraries and APIs
  • Server-side content

​
Quality Standards

Required
  • Clear project description
  • Accurate version compatibility
  • Proper categorization
  • Appropriate screenshots
  • Working download files
Best Practices
  • Detailed changelogs
  • License information
  • Dependency documentation
  • Installation instructions
  • Support contact information

​
Prohibited Content

The following content is not allowed on Modrinth:
  • Malware or harmful code
  • Cheats or unfair advantages in multiplayer
  • Stolen or plagiarized content
  • NSFW or inappropriate content
  • Spam or low-effort projects
  • Copyright violations

​
Moderation

All uploaded content is reviewed:
  • Automated scanning for malware
  • Manual review for policy compliance
  • Community reporting system
  • Quick moderation response times
  • Appeal process for rejections

​
Platform Benefits

​
For Players

Easy Discovery

  • Lightning-fast search
  • Smart recommendations
  • Curated collections
  • Follow system for updates

Safe Downloads

  • Malware scanning
  • Verified creators
  • Open source code links
  • File hash verification

Launcher Integration

  • Modrinth App support
  • Third-party launcher compatibility
  • One-click installations
  • Automatic updates

Free Forever

  • No premium tiers
  • Unlimited downloads
  • Ad-free browsing
  • Community-driven

​
For Creators

Revenue Sharing

  • Ad revenue from project pages
  • Team monetization splits
  • Transparent earnings
  • Easy withdrawals

Growth Tools

  • Detailed analytics
  • Discovery algorithms
  • Featured project spots
  • Community engagement

Collaboration

  • Team management
  • Permission system
  • Version control
  • Multi-creator support

Developer Tools

  • Open API
  • CI/CD integration
  • Automated uploads
  • Build tool plugins

​
Open Source

Modrinth is committed to open source:
  • Platform code: Available on GitHub
  • API: Fully documented and open
  • Community-driven: Feature requests welcome
  • Transparent: Public roadmap and decisions
Contribute to Modrinth on GitHub or join the Discord community to get involved.