Version 1.2.1-hotfix

Overview

Hotfix for clickable suggestion components that stopped working in v1.2.1

Fixes

• Clickable Suggestions: Partially reverted SuggestedResponseHandler to restore click-to-use functionality for suggested responses
• Component Compatibility: Fixed text component rendering issue where [Click to use] was displayed as plain text instead of an interactive element

---

Version 1.2.1

Overview

This release introduces Markdown formatting support for AI responses.

New Features

• Markdown Formatting: AI responses are now automatically converted from Markdown to Minecraft-compatible formatting.

Changes

• Formatter Integration: ConfigManager now manages Markdown formatting settings with configurable options in config.yml

Technical

• Markdown conversion supports: headers, bold, italic, strikethrough, code blocks, lists, blockquotes, links, and horizontal rules

Version 1.2.0

Overview

This release introduces Folia server compatibility and refactors the search module

New Features

• Folia Compatibility: New scheduler abstraction layer compatible with Bukkit, Spigot, Paper, and Folia

Changes

• Web Search Module Restructured: Moved WebSearchService, BochaSearchService, and BraveSearchService into dedicated com.ollamachat.search package for better code organization

Version 1.1.9

Overview

This release focuses on improving the help system, enhancing the plugin API, and adding bStats metrics integration for better usage analytics.

New Features

• Enhanced Help System: Added /ollamachat help command with detailed subcommand documentation, providing clearer usage instructions for all commands
• API Improvements: Refined the public API interface for better third-party plugin integration, with more consistent method naming and error handling
• bStats Integration: Added anonymous usage statistics collection via bStats (https://bstats.org/). You can opt-out by modifying the plugins/bStats/config.yml file

Changes

• Improved command feedback messages with better formatting and color coding
• Updated language files with comprehensive help entries

---

Version 1.1.8

Overview

This major release introduces comprehensive web search capabilities with multi-engine support (Bocha and Brave), enhanced configuration management, and improved user experience with new commands and language switching. The update focuses on bringing real-time information retrieval to AI conversations while maintaining flexibility for international users. This version supports Minecraft 1.20.x through 1.21.x.

New Features

• Web Search Integration:

  • Added support for two search engines: Bocha (Chinese-focused) and Brave (International)
  • Automatic web search when messages contain trigger keywords (configurable)
  • Manual search command /ollamachat search query <text> for on-demand searches
  • Search results are formatted and fed to AI for informed responses
  • Configurable result count (1-50), site filtering, and time range restrictions

• Multi-Engine Support:

  • Bocha Search Engine: Chinese-focused search with site inclusion/exclusion, time range, and freshness filters
  • Brave Search Engine: International search with country, language, and safe search settings
  • Easy switching between engines via /ollamachat search engine <name>

• New Search Management Commands:

  • /ollamachat search toggle - Enable/disable web search
  • /ollamachat search status - View current search configuration
  • /ollamachat search engine [name] - Show/change search engine
  • /ollamachat search setkey <engine> <key> - Set API key for engines
  • /ollamachat search setcount <number> - Configure result count
  • /ollamachat search addkeyword <word> - Add trigger keywords
  • /ollamachat search removekeyword <word> - Remove trigger keywords
  • /ollamachat search listkeywords - List all trigger keywords

• Language System Improvements:

  • Hot-reload language files with /ollamachat reload

Enhancements

• Configuration:

  • Added complete web-search configuration section with detailed comments
  • Engine-specific configuration blocks for Bocha and Brave
  • Configurable trigger keywords for automatic search
  • Customizable search prompt template for AI context
  • Removed config-version for simpler upgrades

• Performance:

  • Asynchronous search operations to prevent server lag
  • Efficient result parsing and formatting
  • Connection pooling for search API requests

Configuration Example

web-search:
  enabled: false
  auto-trigger: true
  trigger-keywords:
    - "search"
    - "find"
    - "what is"
  result-count: 5
  engine: "brave"
  
  bocha:
    api-key: ""
    include-sites: false
    include-sites-list: []
    exclude-sites: false
    exclude-sites-list: []
    time-range: 0
    freshness: ""
  
  brave:
    api-key: ""
    country: "US"
    search-lang: "en"
    ui-lang: "en"
    safe-search: "moderate"
  
  prompt-template: "Based on the following search results... {search_results} ... {prompt}"

Permissions:

• New permissions added for search management:
  • ollamachat.search.toggle - Enable/disable search
  • ollamachat.search.status - View search status
  • ollamachat.search.query - Perform manual searches
  • ollamachat.search.setkey - Set API keys
  • ollamachat.search.setcount - Configure result count
  • ollamachat.search.keywords - Manage trigger keywords
  • ollamachat.search.engine - Change search engine

Commands Usage Examples

# Enable web search
/ollamachat search toggle

# Change search engine to Bocha
/ollamachat search engine bocha

# Set Brave API key
/ollamachat search setkey brave your-api-key-here

# Perform manual search
/ollamachat search query latest Minecraft updates

# Add trigger keyword
/ollamachat search addkeyword research

# Check search status
/ollamachat search status

# Reload configuration with new language
/ollamachat reload

• API Keys:

  • Bocha API key: Get from https://www.bochaai.com/
  • Brave API key: Get from https://api.search.brave.com/app/keys
  • Both engines require valid API keys to function

• Language Files:

  • Update language files to include new search-related keys

---

Version 1.1.7

Overview

This release introduces web search capabilities through Brave Search API integration, allowing AI responses to leverage real-time information from the internet. Players can now trigger web searches directly in chat to get up-to-date, informed answers from the AI.

New Features

• Brave Search Integration:
  • Added web search functionality using Brave Search API for real-time information retrieval.
  • Players can trigger searches with @web <query> in chat messages.
  • Search results are automatically fed into AI prompts for context-aware responses.
• Configurable Search Settings:
  • Added brave-search section to config.yml with enabled and api-key options.
  • New language messages for search feedback: search-searching, search-empty-query, and search-error.
• Chat-based Search:
  • Added @web prefix support for triggering web searches directly from chat.

Version 1.1.6

Bug Fixes

• Fixed HikariCP dependency loading for MySQL connections

Version 1.1.5

Overview

This release reintroduces HikariCP for enhanced MySQL database performance and adds a public API for other plugins to interact with OllamaChat's AI chat functionality. It focuses on improving database efficiency, extensibility, and developer integration while maintaining compatibility with existing configurations.

New Features

• HikariCP Integration:
  • Added HikariCP connection pooling for MySQL databases to improve performance and resource management.
  • Configurable HikariCP settings in config.yml under database.mysql.hikari for tuning connection pool parameters (e.g., maximum-pool-size, connection-timeout).
• Public API:
  • Introduced OllamaChatAPI interface (com.ollamachat.api.OllamaChatAPI) for other plugins.
  • Supports sending AI queries, managing conversations, and accessing chat history programmatically with methods like sendAIQuery, createConversation, and listConversations.
  • Added API documentation in API.md for developer integration.

Enhancements

• Database Management:
  • Updated DatabaseManager to leverage HikariCP for MySQL connections, while preserving SQLite functionality.
• Dependency Management:
  • Updated DependencyLoader to include HikariCP (version 5.1.0) alongside MySQL and SQLite JDBC drivers, downloaded at runtime to plugins/OllamaChat/libs.
  • Maintained compileOnly in build.gradle for non-Paper dependencies to minimize JAR size.
• Configuration:
  • Added database.mysql.hikari section to config.yml with default settings for connection pooling.
  • Improved config.yml comments for clarity and ease of use.

Bug Fixes

• No specific bug fixes in this release, as the focus was on new features and performance improvements.

API Usage Example

Plugin ollamaPlugin = getServer().getPluginManager().getPlugin("OllamaChat");
if (ollamaPlugin != null && ollamaPlugin.isEnabled()) {
    OllamaChatAPI api = ((com.ollamachat.core.Ollamachat) ollamaPlugin).getAPI();
    api.sendAIQuery(player, "ollama", "Hello, how are you?")
        .thenAccept(response -> player.sendMessage("AI Response: " + response));
}

Configuration Example

database:
  type: mysql
  mysql:
    host: localhost
    port: 3306
    database: ollamachat
    username: root
    password: ""
    hikari:
      maximum-pool-size: 10
      connection-timeout: 30000

Notes for Upgrading

• Configuration:
  • Update config.yml to include the database.mysql.hikari section if using MySQL. Default values are added automatically.
  • Backup existing config.yml before updating to avoid data loss.
• Dependencies:
  • The plugin downloads HikariCP (version 5.1.0) automatically on first startup. Ensure server internet access or verify HikariCP-5.1.0.jar in plugins/OllamaChat/libs.
  • Delete the libs folder to force re-download if dependencies are corrupted.
• API Integration:
  • Developers can hook into OllamaChat using OllamaChatAPI. Add softdepend: [OllamaChat] to plugin.yml and refer to API.md.
• Compatibility:
  • This update is backward-compatible with existing configurations and databases.
• Testing:
  • Test database operations (e.g., /ollamachat conversation new) to verify MySQL/SQLite functionality.
  • Check server logs for dependency loading or database errors.

Known Issues

• HikariCP settings may require manual tuning for optimal performance based on server load and MySQL configuration.

版本 1.1.5

概述

本次更新重新引入HikariCP以提升MySQL数据库性能，并新增公共API供其他插件与OllamaChat的AI聊天功能交互。重点改进数据库效率、可扩展性和开发者集成，同时保持与现有配置的兼容性。

新特性

• HikariCP集成：
  • 为MySQL数据库添加HikariCP连接池，提升性能和资源管理
  • 在config.yml的database.mysql.hikari下可配置连接池参数（如maximum-pool-size、connection-timeout）
• 公共API：
  • 新增OllamaChatAPI接口（com.ollamachat.api.OllamaChatAPI）
  • 支持通过编程方式发送AI查询、管理会话和访问聊天记录（如sendAIQuery、createConversation、listConversations等方法）
  • 开发者文档见API.md

功能增强

• 数据库管理：
  • 更新DatabaseManager以使用HikariCP管理MySQL连接，同时保留SQLite功能
• 依赖管理：
  • 更新DependencyLoader包含HikariCP（5.1.0版）及MySQL/SQLite驱动，运行时下载至plugins/OllamaChat/libs
  • 保持build.gradle中非Paper依赖使用compileOnly以减小JAR体积
• 配置优化：
  • 在config.yml新增database.mysql.hikari配置段
  • 改进配置注释的清晰度

问题修复

• 本版本主要侧重新功能和性能提升，无特定问题修复

API使用示例

Plugin ollamaPlugin = getServer().getPluginManager().getPlugin("OllamaChat");
if (ollamaPlugin != null && ollamaPlugin.isEnabled()) {
    OllamaChatAPI api = ((com.ollamachat.core.Ollamachat) ollamaPlugin).getAPI();
    api.sendAIQuery(player, "ollama", "你好吗？")
        .thenAccept(response -> player.sendMessage("AI回复: " + response));
}

配置示例

database:
  type: mysql
  mysql:
    host: localhost
    port: 3306
    database: ollamachat
    username: root
    password: ""
    hikari:
      maximum-pool-size: 10
      connection-timeout: 30000

升级须知

• 配置：
  • 使用MySQL需更新config.yml添加hikari配置段（默认值会自动生成）
  • 升级前备份现有配置
• 依赖：
  • 首次启动自动下载HikariCP（5.1.0版），确保服务器联网或检查plugins/OllamaChat/libs目录
  • 依赖损坏时可删除libs文件夹强制重新下载
• API集成：
  • 开发者可通过OllamaChatAPI集成，在plugin.yml添加softdepend: [OllamaChat]并参考API.md
• 兼容性：
  • 保持与现有配置和数据库的向后兼容
• 测试建议：
  • 测试数据库操作（如/ollamachat conversation new命令）
  • 检查服务器日志中的依赖加载和数据库错误

已知问题

• HikariCP参数可能需要根据服务器负载手动调优