当前位置：首页 > news >正文

如何为Ingress Intel Total Conversion开发插件？开发者入门指南

news 2026/6/6 5:17:40

如何为Ingress Intel Total Conversion开发插件？开发者入门指南

【免费下载链接】ingress-intel-total-conversioningress.com/intel total conversion user script with some new features. Should allow easier extension of the intel map.项目地址: https://gitcode.com/gh_mirrors/in/ingress-intel-total-conversion

Ingress Intel Total Conversion（IITC）是一款功能强大的用户脚本，能够增强Ingress游戏的intel地图体验。本文将为开发者提供一份完整指南，帮助你快速入门IITC插件开发，解锁地图的无限扩展可能。

为什么选择开发IITC插件？

IITC插件生态系统为玩家提供了丰富的自定义功能，从地图增强到数据分析，几乎无所不能。开发插件不仅能满足个人需求，还能与全球玩家社区分享创意。目前，项目的plugins/目录已包含超过50种官方插件，涵盖从基础功能到高级工具的各种应用。

IITC增强后的Ingress intel地图界面，支持多种插件扩展功能

插件开发准备工作

环境搭建

克隆项目仓库

git clone https://gitcode.com/gh_mirrors/in/ingress-intel-total-conversion

熟悉项目结构
核心代码位于code/目录，插件开发主要关注plugins/目录。建议先阅读HACKING.md了解开发规范。
必备工具
- 代码编辑器（如VS Code）
- 浏览器开发者工具
- Tampermonkey或GreaseMonkey插件管理器

插件基础架构

用户脚本元数据

每个IITC插件都是一个用户脚本，必须以// ==UserScript==开头，包含名称、版本、匹配URL等关键信息：

// ==UserScript== // @id my-first-iitc-plugin // @name IITC Plugin: My First Plugin // @version 0.1 // @namespace https://github.com/iitc-project/ // @description A simple IITC plugin example // @include https://intel.ingress.com/* // @grant none // ==/UserScript==

插件注册模式

所有插件需通过IITC.plugin.register方法注册，确保在IITC加载完成后执行：

function wrapper(plugin_info) { // 插件代码主体 plugin_info.buildName = 'my-first-plugin'; plugin_info.dateTimeVersion = '20240101'; plugin_info.pluginId = 'EXAMPLE'; // 注册插件 IITC.plugin.register('My First Plugin', plugin_info); }

核心开发技巧

利用钩子系统

IITC提供丰富的钩子（Hooks）让插件与主程序交互。常用钩子包括：

portalAdded: 新portal加载时触发

window.addHook('portalAdded', function(data) { // 处理新portal数据 console.log('New portal:', data.portal); });

mapDataRefreshEnd: 地图数据刷新完成后触发

window.addHook('mapDataRefreshEnd', function() { // 更新地图显示 updateCustomMapLayers(); });

完整钩子列表可查看code/hooks.js文件。

操作地图元素

通过Leaflet地图API可以轻松添加自定义图层和标记：

// 创建自定义图层 var customLayer = L.layerGroup().addTo(map); // 添加自定义标记 function addCustomMarker(lat, lng, text) { var marker = L.marker([lat, lng]).addTo(customLayer); marker.bindPopup(text); }

使用IITC钩子系统开发的绘图工具插件，支持在地图上绘制自定义图形

实战案例：开发简单的Portal高亮插件

步骤1：创建插件文件

在plugins/目录下新建portal-highlighter-example.user.js文件。

步骤2：实现高亮逻辑

function wrapper(plugin_info) { // 注册插件 IITC.plugin.register('Example Portal Highlighter', plugin_info); // 定义高亮函数 function highlightPortals() { $('div.portal').each(function() { var portal = this; // 高亮所有Level 8 Portal if (portal.getAttribute('data-level') == '8') { portal.style.boxShadow = '0 0 10px red'; } }); } // 注册钩子 window.addHook('mapDataRefreshEnd', highlightPortals); }