X-Mate│엑스메이트

X-Mate는 X와 Discord에 새로운 컨텐츠가 올라오면 인게임에 공지해주고, 명령어로 X에 게시물을 올릴 수 있는 플러그인입니다.
─
X-Mate is a plugin that notifies players in-game whenever new content is posted on X or Discord. It also allows you to post content on X using commands.

• X·Discord의 새 콘텐츠 감지 — X 게시물과 Discord 채널의 새 메시지를 주기적으로 확인하여 이를 인게임에 공지합니다.
• 멘션 필터 — 서비스별로 지정한 멘션이 포함된 콘텐츠만 공지되게 할 수 있습니다.
• 다양한 공지 방식 — 공지를 액션바, 보스바, 채팅, 스코어보드에 동시에 출력되게 수 있습니다.
• 최근 공지 다시 보기와 X 게시 — 명령어로 최근 X·Discord 공지를 다시 보거나, 명령어로 X 게시물을 작성할 수 있습니다.
• 다국어 지원 — 한국어, 영어, 일본어를 제공합니다.

─

• X · Discord New Content Detection — Periodically checks for new posts on X and messages in Discord channels and announces them in-game.
• Mention Filter — You can configure specific mentions for each service so that only content containing the specified mentions is announced.
• Multiple Announcement Methods — Announcements can be displayed simultaneously via the action bar, boss bar, chat, and scoreboard.
• View Recent Announcements & Post to X — Use commands to view recent X and Discord announcements or create and publish posts on X.
• Multilingual Support — Supports Korean, English, and Japanese.

1. X-Mate-○.○.○.jar를 서버의 plugins 폴더에 넣고 서버를 시작합니다.
2. 생성된 plugins/X-Mate/config.yml에 X 계정 및 OAuth 1.0a 인증 정보, Discord 봇 토큰과 채널 ID를 입력합니다. 사용하지 않는 연동은 비활성화할 수 있습니다.
3. Discord 봇에 채널 보기·메시지 기록 읽기 권한을 부여하고, 필요한 경우 Message Content Intent를 활성화합니다.
4. 서버를 다시 시작하거나 /xmate reload를 실행합니다.

※ 플러그인 기본 언어는 영어입니다. 한국어로 바꾸려면 config.yml의 language를 ko-kr로 바꿔주세요.
─

1. Put X-Mate-○.○.○.jar in your server's plugins folder and start the server.
2. Enter the X account and OAuth 1.0a credentials, plus the Discord bot token and channel ID, in plugins/X-Mate/config.yml. Disable an integration if you do not use it.
3. Give the Discord bot View Channel and Read Message History permissions, and enable Message Content Intent when required.
4. Restart the server or run /xmate reload.

이용자 명령어│Player Commands

• /xmate announce x
• 최근 X 공지를 명령어 실행자에게 표시합니다.
• Shows the latest X announcement only to you.

• /xmate announce discord
• 최근 Discord 공지를 명령어 실행자에게 표시합니다.
• Shows the latest Discord announcement only to you.

• /xmate announce all
• 두 서비스의 최근 공지를 명령어 실행자에게 각각 표시합니다.
• Shows each service's latest announcement separately.

관리자 명령어│Admin Commands

• /xmate post <message>
• X 게시물을 작성합니다.
• Publishes an X post.

• /xmate reload
• 설정과 언어 파일을 다시 불러옵니다.
• Reloads configuration and language files.

기타 명령어│Other Commands

• /xmate
• 플러그인 정보를 확인합니다.
• Shows plugin information.

• /xmate help
• 명령어 목록을 확인합니다.
• Shows command help.

권한 (퍼미션)│Permissions

• xmate.user
• 이용자 명령어 묶음
• Player commands.
• (Default: true)

• xmate.post
• X 게시물 작성
• Create X posts.
• (Default: op)

• xmate.admin
• 관리자 명령어 묶음
• Admin commands.
• (Default: op)

플레이스홀더│Placeholders

• %xmate_x_author%
• 게시물 게시자 (X)
• Post author (X)

• %xmate_x_content%
• 게시물 내용 (X)
• Post content (X)

• %xmate_discord_author%
• 메시지 작성자 (Discord)
• Message author (Discord)

• %xmate_discord_content%
• 메시지 (Discord)
• Message (Discord)

통계│Metrics
X-Mate는 익명 서버 통계를 위해 bStats를 사용합니다. 원하지 않는 경우 config.yml에서 비활성화할 수 있습니다.
─
X-Mate uses bStats for anonymous server statistics. You can disable it in config.yml.

문의│Contact
[email protected]