SLNE-Development/surf-api

Surf Language Api

Open

#158 opened on Oct 23, 2025

View on GitHub
 (2 comments) (0 reactions) (0 assignees)Kotlin (0 forks)auto 404
good first issuestatus: needs triage

Repository metrics

Stars
 (5 stars)
PR merge metrics
 (PR metrics pending)

Description

Add i18n support with adventure internalization api.

  • register new language files per-plugin (surfLangApi.registerLocale(file) to the Globaltranslator
  • automatically geht lang code from file (name)
  • MiniMessage support
  • Surf Color Tags/Placeholder Like for primary color.

This can be useful for internalization in surf legal and other projects.

Contributor guide

Research direction
Study the existing plugin API and how locales are currently managed. Implement a registerLocale method that accepts a file, extracts the language code from the filename, and adds it to a global translator. Ensure support for MiniMessage and custom color tags like <primary>. Test with sample language files.
Tech stack
kotlin
Domain
backendapi
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
KotlinSurf API framework knowledge
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
40