1.2.1

GeoFS Model Importer v1.2.1 Release Notes

This update introduces heading control and improves the user interface interaction.

New Features:

Heading Control: Added a new slider and input field to adjust the model's heading (rotation) from 0° to 360°. You can now align models precisely with runways or cardinal directions.

Improvements:

Better Input Handling: Refactored the logic for Scale and Heading text inputs. Typing numbers manually is now smoother and prevents values from jumping or resetting unexpectedly while typing.

Meta Changes:

Update Source: Migrated download and update URLs to GreasyFork for better stability.
License: Added @license MIT.

1.1.0 Special

🚀 GeoFS-Model-Importer 1.1.0 Special Released

We are excited to announce GeoFS-Model-Importer 1.1.0, which focuses on dramatically simplifying the installation and loading process for all users. This update introduces a brand new method to access the importer instantly.

✨ Key Feature: Instant Loading via Bookmarklet
The primary feature of this release is the introduction of a dedicated Bookmarklet script. This change makes accessing the importer easier and faster than ever before.

One-Click Access: Users no longer need to manually copy and paste the large user script code every time. The new bookmarklet allows you to load the importer by simply clicking a bookmark in your browser.

Simplified Installation: The new method significantly reduces the friction of first-time setup, providing a quick and efficient way to integrate the importer into your GeoFS workflow.

🌐 How to Install 1.1.0 Special
Find the Bookmarklet: Locate the bookmarklet.js in the repository.

Add to Browser: Follow the instructions to drag and drop the bookmarklet to your browser's toolbar.

Click and Go: Simply click the saved bookmark on the GeoFS page to instantly load the Model Importer!

We recommend all users switch to this new, more convenient method for seamless access to the importer.

1.1.0

Release Notes for GeoFS-Model-Importer 1.1.0

We are pleased to release GeoFS-Model-Importer 1.1.0. This version introduces significant quality-of-life enhancements and structural improvements to the model placement process.

✨ New Features and Enhancements

1. Center of Mass (CoM) Marker Display
   A new visualization feature has been added to aid in precise model positioning:

New UI Toggle: A checkbox has been added to the control panel to easily show or hide the Center of Mass Marker.

Visual Aid: When placing a model, a visible marker (a red dot) is now displayed at the model's exact anchor point, allowing for more accurate placement and debugging.

2. Enhanced Model Management and Stability
   The logic for handling placed models has been completely overhauled for better stability and performance:

Mandatory Cleanup: Placing a new model or using a model as an aircraft will now automatically remove all previously placed static and aircraft models. This prevents conflicts and ensures a clean scene for every new import.

Robust Removal: New cleanup functions were implemented to properly remove custom aircraft models (including their continuous update listeners) and static models along with their CoM markers, eliminating potential memory leaks and ghost models.

1.0.1

GeoFS-Model-Importer 1.0.1 Release Notes

We are pleased to announce the release of GeoFS-Model-Importer 1.0.1. This is a crucial patch update focused entirely on improving the stability and reliability of the tool by fixing a potential crash that could occur during model import in specific scenarios.

Key Update
🛡️ Critical Bug Fix: Fixed Potential Crash During Model Loading

Issue Description: In 1.0.0, the model importer could crash when attempting to load aircraft models that lacked texture coordinates (UVs). The application would try to process null or non-existent data, leading to a fatal exception.

Solution: Robustness checks have been added to the core import logic. The importer now safely verifies the presence of valid UV data before proceeding with texture handling. If UVs are missing, the process is safely skipped, ensuring that model import completes without crashing.

I strongly recommend all users upgrade to 1.0.1 for a more stable model importing experience.

1.0.0

GeoFS Model Importer - Version 1.0.0 Release Notes

🎉 Initial Release!

GeoFS Model Importer is a powerful userscript that allows you to import and use custom 3D models in the GeoFS flight simulator.

✨ Key Features

🚀 Core Functionality

GLTF/GLB Model Import - Support for importing standard GLTF and GLB 3D model files

Two Usage Modes:

Place Model - Place static models at your current location

Replace Aircraft - Use custom models to replace your current aircraft

Real-time Scaling - Adjust model scale from 0.1x to 5.0x with slider and numeric input

Aircraft Synchronization - Models automatically match your aircraft's position and heading

🎮 User Interface

Draggable Control Panel - Move the interface anywhere on screen

Intuitive Controls - Simple file selection and parameter adjustment

Responsive Design - Automatically adapts to different screen sizes

Professional Styling - Clean, dark theme that matches GeoFS aesthetic

🔧 Technical Features

Real-time Updates - Models update position/orientation every frame

Proper Coordinate Handling - Accurate geographic positioning using Cesium coordinates

Error Handling - Comprehensive error messages and validation

Auto-update Support - Built-in update mechanism for future versions

📋 System Requirements

Browser: Chrome, Firefox, Edge, or other modern browsers

GeoFS Version: Compatible with GeoFS 3.9 and other versions

File Format: GLTF or GLB 3D models

Extensions: Requires Tampermonkey or similar userscript manager

🚀 Getting Started

Install the userscript in your browser extension

Load GeoFS and wait for the "Model Importer" button to appear

Click the button to open the control panel

Select your GLTF/GLB model file

Adjust scale as needed

Choose "Place Here" or "Use as Aircraft"

🐛 Known Issues

Some complex GLTF models may not render correctly

Very large models may impact performance

Aircraft replacement may have occasional visual glitches

👥 Credits

Developed by: GeofsExplorer and 31124呀

Special Thanks: ChatGPT for assistance with auto-update functionality

Open Source: Available on GitHub under MIT License

🔗 Links

GitHub Repository: https://github.com/GeofsExplorer/GeoFS-Model-Importer

Update URL: Automatically configured for future updates

This initial release provides a stable foundation for custom model importation in GeoFS, with plans for additional features and improvements in future versions.

Full Changelog: Version...Version_1.0.0