RubyGem

Aetheryte

A RubyGem web scraper specifically designed for parsing character profiles from the Final Fantasy XIV (FFXIV) Lodestone.

Aetheryte provides a structured way to extract character data from the official FFXIV community site. It handles the complexities of HTML parsing and returns character information in a clean, object-oriented format.

Features

  • Detailed Profile Extraction: Scrapes comprehensive data including City-State, Clan, Gender, Grand Company rank, Race, and a full list of Job levels.
  • Object-Oriented Design: Returns data as a structured Aetheryte::Character object, making it easy to use in your Ruby projects.
  • Robust Parsing: Built on top of nokogiri for reliable and efficient HTML parsing of the Lodestone's complex layouts.
  • Developer Focused: Simplifies the process of building character-tracking tools or community websites for FFXIV.

Installation

Add this line to your application's Gemfile:

gem 'aetheryte'

Usage

require 'aetheryte'
 
# Fetch a character by their Lodestone ID
character = Aetheryte.character(id: '1234567')
 
puts "Name: #{character.name}"
puts "Server: #{character.server}"
puts "Level: #{character.jobs['Paladin']}"