Memory Cache is a plugin API that allows other plugins to store data in-memory and retrieve it later. Plugins have optional features to expire items after a specific amount of time.

CacheItemOptions

Options used to modify the behavior of the cached object

// Gets or sets an absolute expiration date for the cache entry.
public System.DateTimeOffset? AbsoluteExpiration { get; set; }

// Gets or sets an absolute expiration time, relative to now.
public System.TimeSpan? AbsoluteExpirationRelativeToNow { get; set; }

// A callback that is fired when the cached entry is being expired
public System.Action<System.Object> ExpirationCallback { get; set; }

// Gets or sets how long a cache entry can be inactive (e.g. not accessed) before it will be removed.
// This will not extend the entry lifetime beyond the absolute expiration (if set).
public System.Timespan? SlidingExpiration { get; set; }

Requiring Plugin

Not required but allows you to use the CacheItemOptions class helper

// Require: MemoryCache
using System;
using Oxide.Core.Plugins;

namespace Oxide.Plugins
{
  [Info("My Plugin", "austinv90", "1.0.0")]
  public class MyPlugin : CovalencePlugin
  {
    [PluginReference]
    private MemoryCache MemoryCache;
    
    private void Init()
    {
      var options = new MemoryCache.CacheItemOptions()
      {
        SlidingExpiration = TimeSpan.FromMinutes(30)
      }
      
      MemoryCache.Add("MyPlugin_Key0", "I'm a cached string", options);
    }
    
    private void HelloTest()
    {
      // Output: "I'm a cached string"
      Puts(MemoryCache.Get<string>("MyPlugin_Key0"));
    }
  }
}

API

private bool Add(string key, object item, Action<object> expireCallback, DateTimeOffset? absoluteExpire, TimeSpan? slidingExpire);

private bool Add(string key, object item, Action<object> expireCallback, TimeSpan? slidingExpire);

private bool Add(string key, object item, Action<object> expireCallback, DateTimeOffset? absoluteExpire);

private bool Add(string key, object item, TimeSpan? slidingExpire);

private bool Add(string key, object item, DateTimeOffset? absoluteExpire);

private bool Add(string key, object item);

private object Get(string key);

private bool Remove(string key);