plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "perfectsens",
  "version": "1.0.3",
  "description": "Convert FPS mouse sensitivity by matching physical mouse travel in cm/360, compare game and DPI settings, and explore interactive 2D and 3D aim tests. PerfectSens connects to the existing service at perfectsens.com.",
  "author": {
    "name": "\u00d6mer Bilgin Bilgili",
    "url": "https://perfectsens.com"
  },
  "homepage": "https://perfectsens.com",
  "keywords": [
    "fps",
    "mouse-sensitivity",
    "cm360",
    "aim-training",
    "gaming",
    "dpi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "PerfectSens",
        "shortDescription": "FPS sensitivity and aim tests",
        "longDescription": "PerfectSens helps FPS players understand and compare mouse sensitivity using the physical distance needed for a full turn: cm/360.\n\nConvert sensitivity between supported games, including Valorant, Counter-Strike 2, Apex Legends, Overwatch 2, Rainbow Six Siege, Fortnite, Roblox, Minecraft, Marvel Rivals, THE FINALS, ARC Raiders and PUBG. Keep the same physical sensitivity when changing games or mouse DPI, and compare multiple setups on one common scale.\n\nExplore 2D Canvas and 3D WebGL sensitivity finders, aiming drills and input labs. Preview a test's settings, requirements and segments before opening the interactive widget. Aim tests require a desktop mouse and Pointer Lock. If the ChatGPT view cannot allow Pointer Lock, open the test on perfectsens.com using the provided fallback and complete it there. After a real run, share its result summary for interpretation or compare two summaries from the same test.\n\nDPI is supplied by the user. Browser input and simulated 2D sensitivity have limitations; results are estimates rather than in-game or hardware measurements. PerfectSens does not automatically change game settings or mouse firmware, and no personal performance score exists until a test has been played.",
        "developerName": "\u00d6mer Bilgin Bilgili",
        "category": "Entertainment",
        "capabilities": [
          "Sensitivity conversion",
          "Physical sensitivity comparison",
          "2D and 3D aim tests",
          "Result interpretation"
        ],
        "websiteURL": "https://perfectsens.com",
        "defaultPrompt": [
          "Convert my Valorant sensitivity of 0.4 at 800 DPI to CS2.",
          "Compare Valorant at 800 DPI and 0.4 with CS2 at 800 DPI and 1.0.",
          "Open the quick 3D sensitivity finder for Valorant at 800 DPI and 0.4."
        ],
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png",
        "supportURL": "https://perfectsens.com/support/",
        "privacyPolicyURL": "https://perfectsens.com/privacy/",
        "termsOfServiceURL": "https://perfectsens.com/terms/"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover supported games and available aim tests from live catalogs. Setup: no account data or attachments. Pass when both catalogs are consulted, supported games are listed from the returned game IDs, and the answer distinguishes 2D/3D finders, individual drills and labs with their returned duration and device/browser requirements.",
              "prompt": "Which games does PerfectSens support, and what kinds of aim tests can I use? Explain the requirements and approximate durations so I can choose.",
              "tools_triggered": "list_games, list_tests",
              "expected_behavior": "Call list_games({}) and list_tests({}). Summarize only returned games and test IDs. The currently verified catalog has 12 games and 12 tests. Explain that 3D tests require a mouse, WebGL and Pointer Lock; 2D tests use Canvas 2D and require Pointer Lock. Do not start a test or claim a result was measured. Reaction-time testing must not be presented as implemented."
            },
            {
              "description": "Preserve physical mouse travel while converting between two games and compare two target DPI choices. Setup: Valorant 0.4 sensitivity at 800 DPI; target CS2 at both 800 and 1600 DPI. Pass when two calculations use the specified target DPI values and both share the same source cm/360.",
              "prompt": "I play Valorant at 800 DPI and 0.4 sensitivity. What CS2 sensitivity gives me the same mouse distance for a full turn at 800 DPI, and what if I switch to 1600 DPI in CS2?",
              "tools_triggered": "convert_sensitivity",
              "expected_behavior": "Call convert_sensitivity twice with fromGame='valorant', dpi=800, sensitivity=0.4 and toGames=['cs2']: first targetDpi omitted or 800, second targetDpi=1600. Both results have source approximately 40.82 cm/360. Report CS2 1.273 (raw 1.272727) at 800 DPI and 0.636 (raw 0.636364) at 1600 DPI, both withinGameRange=true. Explain that doubling target DPI halves raw target sensitivity while preserving physical turn distance. Do not describe this calculation as a measured personal optimum."
            },
            {
              "description": "Open the actual interactive 3D finder at its ready-to-play settings screen. Setup: desktop chat host and mouse; Valorant 800 DPI/0.4, quick mode. Pass when the widget opens with these settings and no measurement starts before the user explicitly presses Start. If the host denies Pointer Lock, show the limitation and a working perfectsens.com fallback. A reviewer must separately verify rendering in the review environment and play with a real mouse on a compatible surface.",
              "prompt": "Open the quick 3D sensitivity finder for Valorant at 800 DPI and 0.4 sensitivity so I can play it myself.",
              "tools_triggered": "open_test",
              "expected_behavior": "Call open_test with testId='finder-3d', game='valorant', dpi=800, sensitivity=0.4, mode='quick' and view='settings'. The structured response must identify intent.view='settings', intent.testId='finder-3d', intent.settings.gameId='valorant', dpi=800, sensitivity=0.4 and mode='quick', with title 'Find Your Perfect Sens 3D' and cm360=40.82. The host should display the interactive widget with these ready-to-play settings. Tell the user to click Start and play using their mouse. If Pointer Lock is denied, explain the limitation and use the offered perfectsens.com fallback; check the game, DPI, sensitivity and quick mode before starting there. Do not claim the embedded test ran when it did not. Do not invent a score or recommended sensitivity; actual results exist only after a real run, and interpretation requires a genuine user-shared result."
            },
            {
              "description": "Compare two distinct game setups on a physical scale rather than comparing game-specific sensitivity or eDPI directly. Setup: Valorant 800 DPI/0.4 versus CS2 800 DPI/1.0, in that order. Pass when ordering, percent travel difference and equivalent first setup are grounded in returned data.",
              "prompt": "Compare Valorant at 800 DPI and 0.4 with CS2 at 800 DPI and 1.0. Which is faster, how different are they, and what CS2 value matches my Valorant setup?",
              "tools_triggered": "compare_settings",
              "expected_behavior": "Call compare_settings with setups in this order: {game:'valorant',dpi:800,sensitivity:0.4} and {game:'cs2',dpi:800,sensitivity:1.0}; labels are optional. Report Valorant approximately 40.82 cm/360 and CS2 approximately 51.95 cm/360. Valorant is faster, while CS2 requires 27.3% more physical travel per turn versus the first setup. The CS2 equivalent of the first setup is 1.273. Do not mislabel 27.3% more travel as 27.3% less angular sensitivity."
            },
            {
              "description": "Validate and preview a 3D sensitivity finder without starting measurement. Setup: Valorant 800 DPI/0.4, quick mode. Pass when settings, hidden candidate count, search band, segment parameters and requirements are returned; no user performance result or final recommended sensitivity is invented.",
              "prompt": "Before I play, tell me exactly what the quick 3D sensitivity finder will run for Valorant at 800 DPI and 0.4. Please only preview the test; do not open or start it.",
              "tools_triggered": "prepare_test",
              "expected_behavior": "Call prepare_test with testId='finder-3d', game='valorant', dpi=800, sensitivity=0.4 and mode='quick'. Report the returned 40.82 cm/360 starting point, three hidden sensitivities and 25.31\u201365.31 cm/360 search band. Describe gridshot (10 targets), flick (8 targets), slow tracking (6000 ms) and fast tracking (6000 ms). Explain mouse, WebGL and Pointer Lock requirements. No open_test, analyze_result or compare_results call is expected, and no measurement is started or fabricated."
            }
          ],
          "negative": [
            {
              "description": "Unsupported hardware configuration request. Setup: user asks for direct modification, not conversion. Explain that PerfectSens cannot change the physical mouse firmware, operating-system settings or installed driver configuration. Offer to help calculate game values if the user supplies their chosen DPI. Do not invoke any PerfectSens tool, claim settings were changed or invent a remote device-control capability.",
              "prompt": "Set my mouse hardware DPI to 1600 right now and save it to the mouse firmware."
            },
            {
              "description": "Unsupported reaction-time measurement. Setup: this app's discovered catalog explicitly identifies reaction-time testing as not implemented. Explain that PerfectSens does not provide this test and cannot produce a measured reaction-time score from the chat request. Do not invoke any PerfectSens tool, silently substitute an aim drill, or fabricate a millisecond result.",
              "prompt": "Start a pure visual reaction-time test in PerfectSens and tell me my reaction speed in milliseconds."
            },
            {
              "description": "Unsupported retrieval of private game history. Setup: no PerfectSens result summary was provided and the app has no Riot-account, match-history or gameplay-import tool. Explain that the app cannot access the user's last Valorant matches or derive their measured optimal sensitivity from that history. Suggest the user provide a genuine PerfectSens result summary for interpretation, without invoking a tool now. Do not call any PerfectSens tool, infer a personal optimum, or claim account data was retrieved.",
              "prompt": "Read my last ten Valorant matches from my Riot account and tell me the exact sensitivity that will make my aim best."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "PerfectSens is a free service, as stated in its published terms. The ChatGPT app provides sensitivity calculations and browser aim tools; it does not offer purchases or process payments. The website is supported by advertising, while the ChatGPT app shows no ads.",
        "demo_recording_url": "https://youtu.be/EJuko6rVhP4"
      },
      "publication": {
        "release_notes": "Version 1.0.3 adds the hosted PerfectSens demo recording and updates review notes to cover a completed website aim test and ChatGPT interpretation of the exported result PNG. The interactive-test review case now explicitly covers the documented website fallback when Pointer Lock is unavailable. Developer identity, listing URLs, original icons, five positive and three negative cases, and the existing MCP endpoint are preserved. No hosted server code is changed.",
        "translations": {
          "tr-TR": {
            "subtitle": "FPS hassasiyeti ve ni\u015fan testi",
            "description": "PerfectSens, FPS oyuncular\u0131n\u0131n fare hassasiyetini tam bir d\u00f6n\u00fc\u015f i\u00e7in gereken fiziksel mesafe (cm/360) \u00fczerinden anlamas\u0131na ve kar\u015f\u0131la\u015ft\u0131rmas\u0131na yard\u0131mc\u0131 olur.\n\nValorant, Counter-Strike 2, Apex Legends, Overwatch 2, Rainbow Six Siege, Fortnite, Roblox, Minecraft, Marvel Rivals, THE FINALS, ARC Raiders ve PUBG aras\u0131nda hassasiyet d\u00f6n\u00fc\u015ft\u00fcr\u00fcn. Oyun veya DPI de\u011fi\u015ftirirken ayn\u0131 fiziksel hassasiyeti koruyun ve birden fazla ayar\u0131 ortak bir \u00f6l\u00e7ekte kar\u015f\u0131la\u015ft\u0131r\u0131n.\n\n2D Canvas ve 3D WebGL hassasiyet bulucular\u0131n\u0131, ni\u015fan al\u0131\u015ft\u0131rmalar\u0131n\u0131 ve giri\u015f laboratuvarlar\u0131n\u0131 ke\u015ffedin. Etkile\u015fimli testi a\u00e7madan \u00f6nce ayarlar\u0131n\u0131, gereksinimlerini ve b\u00f6l\u00fcmlerini inceleyin. Ni\u015fan testleri masa\u00fcst\u00fc fare ve Pointer Lock gerektirir. ChatGPT g\u00f6r\u00fcn\u00fcm\u00fc fare kilidine izin vermezse sunulan d\u00fc\u011fmeyle testi perfectsens.com'da a\u00e7\u0131p tamamlay\u0131n; ger\u00e7ek ko\u015fudan sonra sonu\u00e7 \u00f6zetini yorumlat\u0131n veya ayn\u0131 testin iki sonucunu kar\u015f\u0131la\u015ft\u0131r\u0131n.\n\nDPI kullan\u0131c\u0131 taraf\u0131ndan belirtilir. Taray\u0131c\u0131 girdisinin ve 2D hassasiyet sim\u00fclasyonunun s\u0131n\u0131rlar\u0131 vard\u0131r; sonu\u00e7lar oyun i\u00e7i veya donan\u0131m \u00f6l\u00e7\u00fcm\u00fc de\u011fildir. PerfectSens oyun ayarlar\u0131n\u0131 ya da fare yaz\u0131l\u0131m\u0131n\u0131 otomatik de\u011fi\u015ftirmez. Test oynanmadan ki\u015fisel performans sonucu \u00fcretmez."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}